File: doxygen_add_docs.patch

package info (click to toggle)
cubeb 0.0~git20250401.975a727%2Bds-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,312 kB
  • sloc: cpp: 16,822; ansic: 8,286; sh: 28
file content (35 lines) | stat: -rw-r--r-- 1,344 bytes parent folder | download | duplicates (3)
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)