[clang] [CIR][Docs][www] Preserve generated dialect reference docs from source sync (PR #234436)

Bruno Cardoso Lopes via cfe-commits cfe-commits at lists.llvm.org
Wed Oct 21 16:57:17 PDT 2026


https://github.com/bcardosolopes created https://github.com/llvm/llvm-project/pull/234436

Complement to #232912: the Sphinx source sync step deletes .md files in the build docs tree that are not checked in unless listed in PRESERVE_FILE. The CIR tablegen outputs landed in the build tree before the sync ran and were pruned, so the post-process step silently found nothing and the reference page never reached the published site. List them alongside the other generated docs.

>From 6e9c386e6643d334c42c0e4331cdf3e6ade2528a Mon Sep 17 00:00:00 2001
From: Bruno Cardoso Lopes <bruno.cardoso at gmail.com>
Date: Wed, 21 Oct 2026 15:53:48 -0700
Subject: [PATCH] [CIR] Preserve generated dialect reference docs from source
 sync

Complement to #232912: the Sphinx source sync step deletes .md files
in the build docs tree that are not checked in unless listed in
PRESERVE_FILE. The CIR tablegen outputs landed in the build tree
before the sync ran and were pruned, so the post-process step
silently found nothing and the reference page never reached the
published site. List them alongside the other generated docs.
---
 clang/docs/CMakeLists.txt | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/clang/docs/CMakeLists.txt b/clang/docs/CMakeLists.txt
index 503ee47c9764cf..cb39b97b168a9a 100644
--- a/clang/docs/CMakeLists.txt
+++ b/clang/docs/CMakeLists.txt
@@ -107,7 +107,10 @@ if (LLVM_ENABLE_SPHINX)
       DiagnosticsReference.md
       AMDGPUBuiltinReference.rst
       ClangCommandLineReference.md
-      analyzer/user-docs/Options.rst)
+      analyzer/user-docs/Options.rst
+      CIR/_raw/CIRDialect.md
+      CIR/_raw/CIRPasses.md
+      CIR/CIRDialect.md)
     add_sphinx_source_sync_target(copy-clang-rst-docs
       "${CMAKE_CURRENT_SOURCE_DIR}" "${CMAKE_CURRENT_BINARY_DIR}"
       PRESERVE_DOCS ${clang_generated_docs})



More information about the cfe-commits mailing list