From b694c904ef80fa05247a13a5e6b7928989453940 Mon Sep 17 00:00:00 2001
From: Martin Hierholzer <martin.hierholzer@desy.de>
Date: Wed, 3 Jun 2026 15:21:43 +0200
Subject: [PATCH] fix: auto-generated doc files should go to build dir

---
 CMakeLists.txt | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/CMakeLists.txt b/CMakeLists.txt
index 32e1b1f..96d5fe0 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -93,10 +93,14 @@ find_package( Sphinx )
 if( SPHINX_EXECUTABLE )
   configure_file( "${PROJECT_SOURCE_DIR}/doc/conf.py.in" "${PROJECT_BINARY_DIR}/conf.py" )
 
-  # copy the config file to the build directory
+  # Copy doc sources to the build directory so Sphinx generates autosummary
+  # stubs (generated/) in the build tree, not the source tree.
+  file(COPY "${PROJECT_SOURCE_DIR}/doc/" DESTINATION "${PROJECT_BINARY_DIR}/doc_src/"
+       PATTERN "*.png" PATTERN "*.ico" PATTERN "*.pdf" PATTERN "*.py.in" EXCLUDE)
+
   message( STATUS "Html documentation support enabled; use 'make doc' to build it." )
   add_custom_target( doc ALL
-    COMMAND "${SPHINX_EXECUTABLE}" -c "${PROJECT_BINARY_DIR}" -b html "${PROJECT_SOURCE_DIR}/doc" "doc/html"
+    COMMAND "${SPHINX_EXECUTABLE}" -c "${PROJECT_BINARY_DIR}" -b html "${PROJECT_BINARY_DIR}/doc_src" "doc/html"
     WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
     COMMENT "Generating HTML documentation" VERBATIM )