Merge pull request #14335 from bangerth/dox-par

dealii · Oct 5, 2022 · eef1949 · eef1949
2 parents 6c763c6 + 2b37efd
commit eef1949
Show file tree

Hide file tree

Showing 2 changed files with 19 additions and 0 deletions.
diff --git a/doc/doxygen/CMakeLists.txt b/doc/doxygen/CMakeLists.txt
@@ -34,6 +34,7 @@ IF(NOT DOXYGEN_FOUND)
     )
 ENDIF()
 
+
 ########################################################################
 #
 # Process the tutorial and code-gallery files into inputs for doxygen
@@ -272,6 +273,19 @@ FILE(APPEND "${CMAKE_CURRENT_BINARY_DIR}/options.dox"
   "
   )
 
+# If we use a reasonably modern doxygen version, make sure it is run in parallel
+IF(NOT (${DOXYGEN_VERSION} VERSION_LESS 1.9))
+  FILE(APPEND "${CMAKE_CURRENT_BINARY_DIR}/options.dox"
+    "
+    NUM_PROC_THREADS       = 0
+    DOT_NUM_THREADS        = 0
+    "
+    )
+  MESSAGE(STATUS "Letting doxygen run with multiple threads")
+ENDIF()
+
+
+
 ########################################################################
 #
 # And, finally, call doxygen:

diff --git a/doc/news/changes/minor/20221004Bangerth b/doc/news/changes/minor/20221004Bangerth
@@ -0,0 +1,5 @@
+New: We now instruct doxygen to build the documentation with multiple
+threads, substantially reducing the amount of time it takes to
+complete this step.
+<br>
+(Wolfgang Bangerth, 2022/10/04)