Генерация документации с помощью Breathe

CMLibBreathe.cmake

@@ -1,3 +1,19 @@
+set(BUILD_BREATHE_DOC AUTO CACHE STRING "Enable documntation in Breathe format")
+set_property(CACHE BUILD_BREATHE_DOC PROPERTY STRINGS AUTO ON OFF)
+
+if(BUILD_BREATHE_DOC STREQUAL AUTO)
+  find_package(Doxygen)
+  find_package(Perl)
+  set(Python_ADDITIONAL_VERSIONS 3.7 3.6 3.5 3.4 3.3 3.2)
+  find_package(PythonInterp)
+  find_package(Sphinx)
+  include(FindPythonModule)
+  find_python_module(breathe)
+  find_python_module(recommonmark)
+  if(DOXYGEN_FOUND AND PERL_FOUND AND SPHINX_FOUND AND breathe AND recommonmark)
+    set(BUILD_BREATHE_DOC ON CACHE STRING "Enable documntation in Breathe format" FORCE)
+  endif()
+elseif(BUILD_BREATHE_DOC)
   find_package(Doxygen REQUIRED)
   find_package(Perl REQUIRED)
   set(Python_ADDITIONAL_VERSIONS 3.7 3.6 3.5 3.4 3.3 3.2)
@@ -5,8 +21,14 @@ find_package(PythonInterp REQUIRED)
   find_package(Sphinx REQUIRED)
   include(FindPythonModule)
   find_python_module(breathe REQUIRED)
+  find_python_module(recommonmark REQUIRED)
+  set(BUILD_BREATHE_DOC ON CACHE STRING "Enable documntation in Breathe format" FORCE)
+else()
+  set(BUILD_BREATHE_DOC OFF CACHE STRING "Enable documntation in Breathe format" FORCE)
+endif()
 
 function(add_breathe_doc)
+  if(BUILD_BREATHE_DOC AND CMAKE_BUILD_TYPE STREQUAL Release)
     set(options)
     set(oneValueArgs
       SOURCE_DIR
@@ -40,6 +62,7 @@ function(add_breathe_doc)
       )
 
     add_custom_target(${BREATHE_DOC_TARGET_NAME}
+      ALL
       COMMAND
       ${SPHINX_EXECUTABLE}
       -q
@@ -52,6 +75,5 @@ function(add_breathe_doc)
       "Building ${BREATHE_DOC_TARGET_NAME} documentation with Breathe, Sphinx and Doxygen"
       VERBATIM
       )
-
+  endif()
-  message(STATUS "Added ${BREATHE_DOC_TARGET_NAME} [Breathe+Sphinx+Doxygen] target to build documentation")
 endfunction()

CMLibCommon.cmake

@@ -33,7 +33,7 @@ include(CMLibBuildTypes)
 include(CMLibCodeAnalysisPvsStudio)
 include(cotire)
 
-#include(CMLibBreathe)
+include(CMLibBreathe)
 include(CMLibQtTranslation)
 include(CMLibToday)
 include(CMLibConfigHPPGenerate)