build: modify target_generate_xml_docs to add_xml_docs function

Author: threeal

.github/workflows/build.yml

@@ -105,9 +105,11 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v3.5.3
 
-      - name: Configure and build documentation
+      - name: Configure project
         uses: threeal/cmake-action@v1.2.0
         with:
           source-dir: ${{ matrix.package }}
           options: BUILD_DOCS=ON
-          run-build: true
+
+      - name: Build documentation
+        run: cmake --build ${{ matrix.package }}/build --target docs

error/CMakeLists.txt

@@ -60,7 +60,7 @@ if(CMAKE_CURRENT_SOURCE_DIR STREQUAL CMAKE_SOURCE_DIR)
 
   # Build XML documentation
   if(BUILD_DOCS)
-    include(cmake/target_generate_xml_docs.cmake)
-    target_generate_xml_docs(error)
+    include(cmake/add_xml_docs.cmake)
+    add_xml_docs(docs include/error/error.hpp)
   endif()
 endif()

error/cmake/add_xml_docs.cmake

@@ -0,0 +1,30 @@
+# A function that generates XML documentation from the specified source files.
+function(add_xml_docs TARGET_NAME)
+  # Try to install Doxygen if not found
+  find_program(DOXYGEN_PROGRAM doxygen)
+  if(NOT DOXYGEN_PROGRAM)
+    find_program(APT_GET_PROGRAM apt-get)
+    if(APT_GET_PROGRAM)
+      message(STATUS "Doxygen could not be found, installing...")
+      execute_process(COMMAND ${APT_GET_PROGRAM} install -y doxygen)
+    endif()
+
+    find_program(BREW_PROGRAM brew)
+    if(BREW_PROGRAM)
+      message(STATUS "Doxygen could not be found, installing...")
+      execute_process(COMMAND ${BREW_PROGRAM} install doxygen)
+    endif()
+  endif()
+
+  # Try to find Doxygen
+  find_package(Doxygen)
+  if(DOXYGEN_FOUND)
+    # Configure Doxygen to generate XML documentation
+    set(DOXYGEN_GENERATE_HTML NO)
+    set(DOXYGEN_GENERATE_XML YES)
+    set(DOXYGEN_XML_OUTPUT ${TARGET_NAME})
+
+    # Generate XML documentation for the target
+    doxygen_add_docs(${TARGET_NAME} ${ARGN} USE_STAMP_FILE)
+  endif()
+endfunction()