1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35
|
Description: Use doxygen_add_docs()
Letting CMake handle the Doxygen target improves reproducibility by
not including absolute build paths in the output.
Author: Andrea Pappacoda <andrea@pappacoda.it>
Forwarded: https://github.com/mozilla/cubeb/pull/726
Last-Update: 2022-09-25
--- cubeb-0.0~git20220922.93d1fa3+ds.orig/CMakeLists.txt
+++ cubeb-0.0~git20220922.93d1fa3+ds/CMakeLists.txt
@@ -366,12 +366,19 @@ endif()
find_package(Doxygen)
if(DOXYGEN_FOUND)
- configure_file(${CMAKE_CURRENT_SOURCE_DIR}/docs/Doxyfile.in ${CMAKE_CURRENT_BINARY_DIR}/docs/Doxyfile @ONLY)
- add_custom_target(doc ALL
- ${DOXYGEN_EXECUTABLE} ${CMAKE_CURRENT_BINARY_DIR}/docs/Doxyfile
- WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/docs
- COMMENT "Generating API documentation with Doxygen" VERBATIM)
- install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/docs/html/ TYPE DOC)
+ set(DOXYGEN_JAVADOC_AUTOBRIEF YES)
+ set(DOXYGEN_OPTIMIZE_OUTPUT_FOR_C YES)
+ set(DOXYGEN_CASE_SENSE_NAMES NO)
+ set(DOXYGEN_SORT_MEMBER_DOCS NO)
+ set(DOXYGEN_QUIET YES)
+ set(DOXYGEN_WARN_NO_PARAMDOC YES)
+ set(DOXYGEN_GENERATE_HTML YES)
+
+ doxygen_add_docs(doc "include/cubeb/" ALL
+ COMMENT "Generating API documentation with Doxygen"
+ )
+
+ install(DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/html/ TYPE DOC COMPONENT Documentation)
endif()
if(BUILD_TESTS)
|