cmlib/CMLibDocDoxygen.cmake

set(DOXYGEN_FOUND
    AUTO
    CACHE STRING "Enable Doxygen documentation generator")
set_property(CACHE DOXYGEN_FOUND PROPERTY STRINGS ON OFF AUTO)

find_package(Doxygen)
if(DOXYGEN_FOUND)
  set(DOXYGEN_FOUND
      ON
      CACHE STRING "Doxygen documentation generator enabled" FORCE)
else()
  set(DOXYGEN_FOUND
      OFF
      CACHE STRING "Doxygen documentation generator disabled" FORCE)
endif()

function(add_doxygen_target)
  set(options)
  set(oneValueArgs TARGET_NAME SQLITE LATEX HTML)
  set(multiValueArgs)

  cmake_parse_arguments(_DOXYGEN "${options}" "${oneValueArgs}" "${multiValueArgs}"
                        ${ARGN})
  if(DOXYGEN_FOUND)
    set(GENERATE_XML NO)
    set(GENERATE_HTML NO)
    set(GENERATE_LATEX NO)
    set(GENERATE_SQLITE YES)
    if(_DOXYGEN_HTML)
      set(GENERATE_HTML YES)
    endif()
    if(_DOXYGEN_LATEX)
      set(GENERATE_LATEX YES)
    endif()
    if(_DOXYGEN_SQLITE)
      set(GENERATE_SQLITE YES)
    endif()

    set(WORK_DIR ${CMAKE_BINARY_DIR}/doc/doxygen)
    configure_file(${CMAKE_SOURCE_DIR}/cmake/doc/Doxyfile.in ${WORK_DIR}/Doxyfile @ONLY)

    add_custom_target(
      ${_DOXYGEN_TARGET_NAME}
      VERBATIM
      COMMAND "${CMAKE_COMMAND}" -E remove -f "${WORK_DIR}/doxygen_sqlite3.db"
      COMMAND ${DOXYGEN_EXECUTABLE} ${WORK_DIR}/Doxyfile
      WORKING_DIRECTORY ${WORK_DIR}
      COMMENT "Generating API documentation with Doxygen")
  else()
    add_custom_target(
      ${_DOXYGEN_TARGET_NAME}
      VERBATIM
      COMMENT "Doxygen is not found. Skipping target ${_DOXYGEN_TARGET_NAME} build")
  endif()
endfunction()