58 lines
1.2 KiB
CMake
58 lines
1.2 KiB
CMake
|
find_package(Doxygen REQUIRED)
|
||
|
|
find_package(Perl REQUIRED)
|
||
|
|
set(Python_ADDITIONAL_VERSIONS 3.7 3.6 3.5 3.4 3.3 3.2)
|
||
|
|
find_package(PythonInterp REQUIRED)
|
||
|
|
find_package(Sphinx REQUIRED)
|
||
|
|
include(FindPythonModule)
|
||
|
|
find_python_module(breathe REQUIRED)
|
||
|
|
|
||
|
|
function(add_breathe_doc)
|
||
|
|
set(options)
|
||
|
|
set(oneValueArgs
|
||
|
|
SOURCE_DIR
|
||
|
|
BUILD_DIR
|
||
|
|
CACHE_DIR
|
||
|
|
HTML_DIR
|
||
|
|
DOXY_FILE
|
||
|
|
CONF_FILE
|
||
|
|
TARGET_NAME
|
||
|
|
COMMENT
|
||
|
|
)
|
||
|
|
set(multiValueArgs)
|
||
|
|
|
||
|
|
cmake_parse_arguments(BREATHE_DOC
|
||
|
|
"${options}"
|
||
|
|
"${oneValueArgs}"
|
||
|
|
"${multiValueArgs}"
|
||
|
|
${ARGN}
|
||
|
|
)
|
||
|
|
|
||
|
|
configure_file(
|
||
|
|
${BREATHE_DOC_CONF_FILE}
|
||
|
|
${BREATHE_DOC_BUILD_DIR}/conf.py
|
||
|
|
@ONLY
|
||
|
|
)
|
||
|
|
|
||
|
|
configure_file(
|
||
|
|
${BREATHE_DOC_DOXY_FILE}
|
||
|
|
${BREATHE_DOC_BUILD_DIR}/Doxyfile
|
||
|
|
@ONLY
|
||
|
|
)
|
||
|
|
|
||
|
|
add_custom_target(${BREATHE_DOC_TARGET_NAME}
|
||
|
|
COMMAND
|
||
|
|
${SPHINX_EXECUTABLE}
|
||
|
|
-q
|
||
|
|
-b html
|
||
|
|
-c ${BREATHE_DOC_BUILD_DIR}
|
||
|
|
-d ${BREATHE_DOC_CACHE_DIR}
|
||
|
|
${BREATHE_DOC_SOURCE_DIR}
|
||
|
|
${BREATHE_DOC_HTML_DIR}
|
||
|
|
COMMENT
|
||
|
|
"Building ${BREATHE_DOC_TARGET_NAME} documentation with Breathe, Sphinx and Doxygen"
|
||
|
|
VERBATIM
|
||
|
|
)
|
||
|
|
|
||
|
|
message(STATUS "Added ${BREATHE_DOC_TARGET_NAME} [Breathe+Sphinx+Doxygen] target to build documentation")
|
||
|
|
endfunction()
|