2023-01-15 03:37:42 +08:00
|
|
|
if(NOT FTXUI_BUILD_DOCS)
|
|
|
|
|
return()
|
|
|
|
|
endif()
|
|
|
|
|
|
2020-05-25 07:34:13 +08:00
|
|
|
find_package(Doxygen)
|
2023-01-15 03:37:42 +08:00
|
|
|
if (NOT DOXYGEN_FOUND)
|
|
|
|
|
message("Doxygen need to be installed to generate the doxygen documentation")
|
|
|
|
|
return()
|
|
|
|
|
endif()
|
2021-07-23 14:40:47 +08:00
|
|
|
|
2023-01-15 03:37:42 +08:00
|
|
|
# Generate example list for documentation
|
|
|
|
|
set(EXAMPLE_LIST "${CMAKE_CURRENT_BINARY_DIR}/example_list.md")
|
|
|
|
|
file(WRITE ${EXAMPLE_LIST} "# Examples")
|
|
|
|
|
get_property(EXAMPLES GLOBAL PROPERTY FTXUI::EXAMPLES)
|
|
|
|
|
foreach(EXAMPLE IN LISTS EXAMPLES)
|
|
|
|
|
file(APPEND ${EXAMPLE_LIST} "\n@example examples/${EXAMPLE}.cpp")
|
|
|
|
|
endforeach(EXAMPLE IN LISTS EXAMPLES)
|
2020-05-25 07:34:13 +08:00
|
|
|
|
2023-01-15 03:37:42 +08:00
|
|
|
configure_file(Doxyfile.in Doxyfile @ONLY)
|
|
|
|
|
|
|
|
|
|
# note the option ALL which allows to build the docs together with the application
|
|
|
|
|
add_custom_target(doc
|
|
|
|
|
COMMAND ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile
|
|
|
|
|
WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
|
|
|
|
|
COMMENT "Generating API documentation with Doxygen"
|
|
|
|
|
VERBATIM
|
|
|
|
|
)
|
