cmlib/CMLibDocDoxygen.cmake

46 lines
1.5 KiB
CMake
Raw Normal View History

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 target)
set(options)
set(oneValueArgs SQLITE LATEX HTML)
set(multiValueArgs)
2020-04-01 18:42:59 +00:00
cmake_parse_arguments(_DOXYGEN "${options}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN})
if(DOXYGEN_FOUND)
set(GENERATE_XML YES)
set(GENERATE_HTML NO)
set(GENERATE_LATEX NO)
if(_DOXYGEN_HTML)
set(GENERATE_HTML YES)
endif()
if(_DOXYGEN_LATEX)
set(GENERATE_LATEX YES)
endif()
2021-06-12 09:59:31 +00:00
set(work_dir ${CMAKE_BINARY_DIR}/doc/doxygen)
configure_file(${CMLIB_MODULE_DIR}/doxygen/Doxyfile.in ${work_dir}/Doxyfile @ONLY)
add_custom_target(
${target}
2020-03-29 05:44:48 +00:00
VERBATIM
2021-06-12 09:59:31 +00:00
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")
install(DIRECTORY ${CMAKE_BINARY_DIR}/doc/doxygen/html/
COMPONENT doc OPTIONAL
DESTINATION ${CMAKE_INSTALL_DATADIR}/doc/doxygen)
else()
message(STATUS "CMLIB warning:")
2020-04-14 09:20:01 +00:00
add_custom_target(${target} VERBATIM COMMENT " Doxygen is not found. Skipping target ${target} build")
endif()
endfunction()