Fix Doxygen documentation

Author: pockerman

.readthedocs.yaml

@@ -28,14 +28,14 @@ ENDIF(COMMAND cmake_policy)
 
 OPTION(ENABLE_TESTS OFF)
 #OPTION(ENABLE_EXAMPLES OFF)
-OPTION(ENABLE_DOCS OFF)
 OPTION(ENABLE_WEBOTS OFF)
 #OPTION(ENABLE_CHRONO OFF)
 
 SET(ENABLE_EXAMPLES ON)
 SET(ENABLE_CHRONO ON)
 SET(ENABLE_OPENCV ON)
 SET(ENABLE_MQTT ON)
+SET(ENABLE_DOCS ON)
 SET(CMAKE_BUILD_TYPE "Release")
 SET(CMAKE_CXX_STANDARD 20)
 SET(CMAKE_CXX_STANDARD_REQUIRED True)

CMakeLists.txt

@@ -4,31 +4,48 @@ IF (NOT DOXYGEN_FOUND)
 	return()
 ENDIF()
 
+
+SET(DOXYGEN_OUTPUT_DIR ${CMAKE_CURRENT_SOURCE_DIR}/docs)
+
+# Configure Doxyfile
+SET(DOXYGEN_IN ${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile.in)
+SET(DOXYGEN_OUT ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile)
+
 # just output XML since this is what Breathe consumes
-SET(DOXYGEN_GENERATE_HTML NO)
-SET(DOXYGEN_GENERATE_XML YES)
+SET(DOXYGEN_GENERATE_HTML YES)
+SET(DOXYGEN_GENERATE_XML NO)
 
 # don't generate documentation from implementation details
-set(DOXYGEN_EXCLUDE_PATTERNS "*/extern/*")
+#SET(DOXYGEN_EXCLUDE_PATTERNS "*/extern/*")
 
 # print paths relative to include directory
-SET(DOXYGEN_STRIP_FROM_PATH "${PROJECT_SOURCE_DIR}/src/gymfcpp")
+#SET(DOXYGEN_STRIP_FROM_PATH "${PROJECT_SOURCE_DIR}/src/bitrl")
+
+configure_file(${DOXYGEN_IN} ${DOXYGEN_OUT} @ONLY)
+
+
+add_custom_target(doc
+		COMMAND ${DOXYGEN_EXECUTABLE} ${DOXYGEN_OUT}
+		WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+		COMMENT "Generating API documentation with Doxygen..."
+		VERBATIM
+)
 
 # Note: use doxygen_add_docs(doxygen-doc ALL ...) if you want your documentation
 # to be created by default each time you build. Without the keyword you need to
 # explicitly invoke building of the 'doc' target.
-doxygen_add_docs(doxygen-doc ${PROJECT_SOURCE_DIR}/src/bitrl COMMENT "Generating API documentation with Doxygen")
-                 
-find_package(Sphinx REQUIRED)
-configure_file(${CMAKE_CURRENT_SOURCE_DIR}/conf.py.in
-               ${CMAKE_CURRENT_BINARY_DIR}/conf.py @ONLY)
-               
-add_custom_target(
-  sphinx-doc ALL
-  COMMAND ${SPHINX_EXECUTABLE} -b html -c ${CMAKE_CURRENT_BINARY_DIR}
-          ${CMAKE_CURRENT_SOURCE_DIR} ${CMAKE_CURRENT_BINARY_DIR}
-  WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
-  COMMENT "Generating API documentation with Sphinx"
-  VERBATIM)
-
-add_dependencies(sphinx-doc doxygen-doc)
+#doxygen_add_docs(doxygen-doc ${PROJECT_SOURCE_DIR}/src/bitrl COMMENT "Generating API documentation with Doxygen")
+#
+#
+#configure_file(${CMAKE_CURRENT_SOURCE_DIR}/conf.py.in
+#               ${CMAKE_CURRENT_BINARY_DIR}/conf.py @ONLY)
+#
+#add_custom_target(
+#  sphinx-doc ALL
+#  COMMAND ${SPHINX_EXECUTABLE} -b html -c ${CMAKE_CURRENT_BINARY_DIR}
+#          ${CMAKE_CURRENT_SOURCE_DIR} ${CMAKE_CURRENT_BINARY_DIR}
+#  WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
+#  COMMENT "Generating API documentation with Sphinx"
+#  VERBATIM)
+#
+#add_dependencies(sphinx-doc doxygen-doc)

doc/CMakeLists.txt

@@ -14,6 +14,6 @@ GENERATE_HTML          = YES
 HTML_OUTPUT            = .
 
 EXTRACT_ALL            = YES
-
+EXCLUDE = @PROJECT_SOURCE_DIR@/src/bitrl/extern
 #---------------------------------------------------------------------------