emsha/cmake/docs.cmake

30 lines
869 B
CMake
Raw Normal View History

2023-10-18 06:43:18 +00:00
# Doxygen support for scsl.
find_package(Doxygen)
if (${DOXYGEN_FOUND})
# prefer scdocs for manpages.
set(DOXYGEN_GENERATE_MAN YES)
2023-10-18 06:43:18 +00:00
set(DOXYGEN_GENERATE_LATEX YES)
set(DOXYGEN_EXTRACT_ALL YES)
set(DOXYGEN_USE_MDFILE_AS_MAINPAGE "${CMAKE_CURRENT_SOURCE_DIR}/README.md")
2023-10-18 10:39:27 +00:00
set(DOXYGEN_EXCLUDE_PATTERNS "test_*" "*.cc" )
2023-10-18 06:43:18 +00:00
message(STATUS "Doxygen found, building docs.")
doxygen_add_docs(${PROJECT_NAME}_docs
${HEADER_FILES}
2023-10-18 10:39:27 +00:00
ALL
2023-10-18 06:43:18 +00:00
USE_STAMP_FILE)
2023-10-22 08:48:55 +00:00
add_custom_target(deploy-docs
COMMAND rsync --delete-after --progress -auvz ${CMAKE_CURRENT_BINARY_DIR}/html/* docs.shimmering-clarity.net:sites/cc/${PROJECT_NAME}/
DEPENDS emsha_docs
)
2023-10-18 06:43:18 +00:00
install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html
${CMAKE_CURRENT_BINARY_DIR}/latex
DESTINATION share/doc/${PROJECT_NAME}/doxygen)
install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/man
DESTINATION share)
endif ()