[clang] [clang][docs] Rename selected Clang docs {.rst, .md} (PR #208307)

[Reid Kleckner via cfe-commits]

https://github.com/rnk updated https://github.com/llvm/llvm-project/pull/208307

>From fd00ac7106b4dadc0c96ebb5ab184e2a9cddb5ea Mon Sep 17 00:00:00 2001
From: Reid Kleckner <rkleckner at nvidia.com>
Date: Wed, 8 Jul 2026 18:52:25 +0000
Subject: [PATCH] [docs] Rename selected Clang docs to Markdown

---
 clang/docs/{HIPSupport.rst => HIPSupport.md}                   | 0
 clang/docs/HLSL/{HLSLDocs.rst => HLSLDocs.md}                  | 0
 clang/docs/InternalsManual.rst                                 | 2 +-
 clang/docs/{LTOVisibility.rst => LTOVisibility.md}             | 0
 clang/docs/{MSVCCompatibility.rst => MSVCCompatibility.md}     | 0
 clang/docs/{MisExpect.rst => MisExpect.md}                     | 0
 clang/docs/{Modules.rst => Modules.md}                         | 0
 clang/docs/{OpenCLSupport.rst => OpenCLSupport.md}             | 0
 clang/docs/{OpenMPSupport.rst => OpenMPSupport.md}             | 0
 .../{OverflowBehaviorTypes.rst => OverflowBehaviorTypes.md}    | 0
 .../{PointerAuthentication.rst => PointerAuthentication.md}    | 0
 clang/docs/{SYCLSupport.rst => SYCLSupport.md}                 | 0
 clang/docs/{SafeStack.rst => SafeStack.md}                     | 0
 ...anitizerSpecialCaseList.rst => SanitizerSpecialCaseList.md} | 0
 clang/docs/{SanitizerStats.rst => SanitizerStats.md}           | 0
 clang/docs/{ShadowCallStack.rst => ShadowCallStack.md}         | 0
 ...{SourceBasedCodeCoverage.rst => SourceBasedCodeCoverage.md} | 0
 ...tandardCPlusPlusModules.rst => StandardCPlusPlusModules.md} | 0
 clang/docs/{StructureProtection.rst => StructureProtection.md} | 0
 clang/docs/{ThinLTO.rst => ThinLTO.md}                         | 0
 clang/docs/{UsersManual.rst => UsersManual.md}                 | 0
 clang/lib/CodeGen/CodeGenModule.cpp                            | 2 +-
 clang/lib/Driver/ToolChains/MSVC.cpp                           | 2 +-
 clang/test/CodeGen/ubsan-type-ignorelist-category.test         | 3 +--
 24 files changed, 4 insertions(+), 5 deletions(-)
 rename clang/docs/{HIPSupport.rst => HIPSupport.md} (100%)
 rename clang/docs/HLSL/{HLSLDocs.rst => HLSLDocs.md} (100%)
 rename clang/docs/{LTOVisibility.rst => LTOVisibility.md} (100%)
 rename clang/docs/{MSVCCompatibility.rst => MSVCCompatibility.md} (100%)
 rename clang/docs/{MisExpect.rst => MisExpect.md} (100%)
 rename clang/docs/{Modules.rst => Modules.md} (100%)
 rename clang/docs/{OpenCLSupport.rst => OpenCLSupport.md} (100%)
 rename clang/docs/{OpenMPSupport.rst => OpenMPSupport.md} (100%)
 rename clang/docs/{OverflowBehaviorTypes.rst => OverflowBehaviorTypes.md} (100%)
 rename clang/docs/{PointerAuthentication.rst => PointerAuthentication.md} (100%)
 rename clang/docs/{SYCLSupport.rst => SYCLSupport.md} (100%)
 rename clang/docs/{SafeStack.rst => SafeStack.md} (100%)
 rename clang/docs/{SanitizerSpecialCaseList.rst => SanitizerSpecialCaseList.md} (100%)
 rename clang/docs/{SanitizerStats.rst => SanitizerStats.md} (100%)
 rename clang/docs/{ShadowCallStack.rst => ShadowCallStack.md} (100%)
 rename clang/docs/{SourceBasedCodeCoverage.rst => SourceBasedCodeCoverage.md} (100%)
 rename clang/docs/{StandardCPlusPlusModules.rst => StandardCPlusPlusModules.md} (100%)
 rename clang/docs/{StructureProtection.rst => StructureProtection.md} (100%)
 rename clang/docs/{ThinLTO.rst => ThinLTO.md} (100%)
 rename clang/docs/{UsersManual.rst => UsersManual.md} (100%)

diff --git a/clang/docs/HIPSupport.rst b/clang/docs/HIPSupport.md
similarity index 100%
rename from clang/docs/HIPSupport.rst
rename to clang/docs/HIPSupport.md
diff --git a/clang/docs/HLSL/HLSLDocs.rst b/clang/docs/HLSL/HLSLDocs.md
similarity index 100%
rename from clang/docs/HLSL/HLSLDocs.rst
rename to clang/docs/HLSL/HLSLDocs.md
diff --git a/clang/docs/InternalsManual.rst b/clang/docs/InternalsManual.rst
index a09e23063858c..27adfae06416d 100644
--- a/clang/docs/InternalsManual.rst
+++ b/clang/docs/InternalsManual.rst
@@ -692,7 +692,7 @@ deterministic manner. This enables features such as implicitly discovered,
 explicitly built modules.
 
 ..
-  TODO: Create and link corresponding section in Modules.rst.
+  TODO: Create and link corresponding section in Modules.md.
 
 Adding new Command Line Option
 ------------------------------
diff --git a/clang/docs/LTOVisibility.rst b/clang/docs/LTOVisibility.md
similarity index 100%
rename from clang/docs/LTOVisibility.rst
rename to clang/docs/LTOVisibility.md
diff --git a/clang/docs/MSVCCompatibility.rst b/clang/docs/MSVCCompatibility.md
similarity index 100%
rename from clang/docs/MSVCCompatibility.rst
rename to clang/docs/MSVCCompatibility.md
diff --git a/clang/docs/MisExpect.rst b/clang/docs/MisExpect.md
similarity index 100%
rename from clang/docs/MisExpect.rst
rename to clang/docs/MisExpect.md
diff --git a/clang/docs/Modules.rst b/clang/docs/Modules.md
similarity index 100%
rename from clang/docs/Modules.rst
rename to clang/docs/Modules.md
diff --git a/clang/docs/OpenCLSupport.rst b/clang/docs/OpenCLSupport.md
similarity index 100%
rename from clang/docs/OpenCLSupport.rst
rename to clang/docs/OpenCLSupport.md
diff --git a/clang/docs/OpenMPSupport.rst b/clang/docs/OpenMPSupport.md
similarity index 100%
rename from clang/docs/OpenMPSupport.rst
rename to clang/docs/OpenMPSupport.md
diff --git a/clang/docs/OverflowBehaviorTypes.rst b/clang/docs/OverflowBehaviorTypes.md
similarity index 100%
rename from clang/docs/OverflowBehaviorTypes.rst
rename to clang/docs/OverflowBehaviorTypes.md
diff --git a/clang/docs/PointerAuthentication.rst b/clang/docs/PointerAuthentication.md
similarity index 100%
rename from clang/docs/PointerAuthentication.rst
rename to clang/docs/PointerAuthentication.md
diff --git a/clang/docs/SYCLSupport.rst b/clang/docs/SYCLSupport.md
similarity index 100%
rename from clang/docs/SYCLSupport.rst
rename to clang/docs/SYCLSupport.md
diff --git a/clang/docs/SafeStack.rst b/clang/docs/SafeStack.md
similarity index 100%
rename from clang/docs/SafeStack.rst
rename to clang/docs/SafeStack.md
diff --git a/clang/docs/SanitizerSpecialCaseList.rst b/clang/docs/SanitizerSpecialCaseList.md
similarity index 100%
rename from clang/docs/SanitizerSpecialCaseList.rst
rename to clang/docs/SanitizerSpecialCaseList.md
diff --git a/clang/docs/SanitizerStats.rst b/clang/docs/SanitizerStats.md
similarity index 100%
rename from clang/docs/SanitizerStats.rst
rename to clang/docs/SanitizerStats.md
diff --git a/clang/docs/ShadowCallStack.rst b/clang/docs/ShadowCallStack.md
similarity index 100%
rename from clang/docs/ShadowCallStack.rst
rename to clang/docs/ShadowCallStack.md
diff --git a/clang/docs/SourceBasedCodeCoverage.rst b/clang/docs/SourceBasedCodeCoverage.md
similarity index 100%
rename from clang/docs/SourceBasedCodeCoverage.rst
rename to clang/docs/SourceBasedCodeCoverage.md
diff --git a/clang/docs/StandardCPlusPlusModules.rst b/clang/docs/StandardCPlusPlusModules.md
similarity index 100%
rename from clang/docs/StandardCPlusPlusModules.rst
rename to clang/docs/StandardCPlusPlusModules.md
diff --git a/clang/docs/StructureProtection.rst b/clang/docs/StructureProtection.md
similarity index 100%
rename from clang/docs/StructureProtection.rst
rename to clang/docs/StructureProtection.md
diff --git a/clang/docs/ThinLTO.rst b/clang/docs/ThinLTO.md
similarity index 100%
rename from clang/docs/ThinLTO.rst
rename to clang/docs/ThinLTO.md
diff --git a/clang/docs/UsersManual.rst b/clang/docs/UsersManual.md
similarity index 100%
rename from clang/docs/UsersManual.rst
rename to clang/docs/UsersManual.md
diff --git a/clang/lib/CodeGen/CodeGenModule.cpp b/clang/lib/CodeGen/CodeGenModule.cpp
index e155fdd752d7f..8e75ac4dd650f 100644
--- a/clang/lib/CodeGen/CodeGenModule.cpp
+++ b/clang/lib/CodeGen/CodeGenModule.cpp
@@ -5109,7 +5109,7 @@ void CodeGenModule::emitMultiVersionFunctions() {
 }
 
 // Symbols with this prefix are used as deactivation symbols for PFP fields.
-// See clang/docs/StructureProtection.rst for more information.
+// See clang/docs/StructureProtection.md for more information.
 static const char PFPDeactivationSymbolPrefix[] = "__pfp_ds_";
 
 llvm::GlobalValue *
diff --git a/clang/lib/Driver/ToolChains/MSVC.cpp b/clang/lib/Driver/ToolChains/MSVC.cpp
index fd3c225d27f03..2b428c56ed1be 100644
--- a/clang/lib/Driver/ToolChains/MSVC.cpp
+++ b/clang/lib/Driver/ToolChains/MSVC.cpp
@@ -944,7 +944,7 @@ VersionTuple MSVCToolChain::computeMSVCVersion(const Driver *D,
                    IsWindowsMSVC)) {
     // -fms-compatibility-version=19.33 is default, aka 2022, 17.3
     // NOTE: when changing this value, also update
-    // clang/docs/CommandGuide/clang.rst and clang/docs/UsersManual.rst
+    // clang/docs/CommandGuide/clang.rst and clang/docs/UsersManual.md
     // accordingly.
     MSVT = VersionTuple(19, 33);
   }
diff --git a/clang/test/CodeGen/ubsan-type-ignorelist-category.test b/clang/test/CodeGen/ubsan-type-ignorelist-category.test
index 70a89d3e31249..480279c7c32bc 100644
--- a/clang/test/CodeGen/ubsan-type-ignorelist-category.test
+++ b/clang/test/CodeGen/ubsan-type-ignorelist-category.test
@@ -101,7 +101,7 @@ void ignore_all_except_myty_divrem(int A, int B, myty C, myty D) {
   (void)(A%B);
 }
 
-// Matches the example from clang/docs/SanitizerSpecialCaseList.rst
+// Matches the example from clang/docs/SanitizerSpecialCaseList.md
 typedef char T;
 typedef char U;
 // TRUNC2-LABEL: docs_example
@@ -113,4 +113,3 @@ void docs_example(int toobig) {
 // TRUNC2-NOT: %handler.implicit_conversion
   char c = toobig;
 }
-