diff options
| author |   Jan-Simon Moeller <jsmoeller@linuxfoundation.org> | 2019-08-20 14:53:08 +0000 |
|---|---|---|
| committer |   Gerrit Code Review <gerrit@automotivelinux.org> | 2019-08-20 14:53:08 +0000 |
| commit | a824dc2de24ac3789207a5fb9d89400bc83891f9 (patch) | |
| tree | da5fde85363c580b44332d6be3813c9b5b14bb99 /docs/CMakeLists.txt | |
| parent | b2cfff1cd378b9e822c7cfa53fc0dd94d2e9103f (diff) | |
| parent | 73aaa91ceac51a96973965827ebc2fbb23d6c234 (diff) | |
Merge "docs: add docs target for generating doxygen output"
Diffstat (limited to 'docs/CMakeLists.txt')
| -rw-r--r-- | docs/CMakeLists.txt | 22 |
1 files changed, 22 insertions, 0 deletions
diff --git a/docs/CMakeLists.txt b/docs/CMakeLists.txt new file mode 100644 index 0000000..2346aff --- /dev/null +++ b/docs/CMakeLists.txt @@ -0,0 +1,22 @@ +# add a target to generate API documentation with Doxygen +find_package(Doxygen) +option(BUILD_DOCUMENTATION "Create and install the HTML based API documentation (requires Doxygen)" ${DOXYGEN_FOUND}) + +if(BUILD_DOCUMENTATION) + if(NOT DOXYGEN_FOUND) + message(FATAL_ERROR "Doxygen is needed to build the documentation.") + endif() + + set(doxyfile_in ${CMAKE_CURRENT_SOURCE_DIR}/Doxyfile.in) + set(doxyfile ${CMAKE_CURRENT_BINARY_DIR}/Doxyfile) + + configure_file(${doxyfile_in} ${doxyfile} @ONLY) + + add_custom_target(docs + COMMAND ${DOXYGEN_EXECUTABLE} ${doxyfile} + WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} + COMMENT "Generating API documentation with Doxygen" + VERBATIM) + + install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html DESTINATION share/doc) +endif() |