[libcxx-commits] [libcxx] [libc++][docs] Rename documentation files to Markdown (batch 2) (PR #222062)

Reid Kleckner via libcxx-commits libcxx-commits at lists.llvm.org
Sat Sep 19 21:07:49 PDT 2026


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

>From 295d2ba3fc45773acf6856fcfca5c677c075406d Mon Sep 17 00:00:00 2001
From: Reid Kleckner <rkleckner at nvidia.com>
Date: Sat, 5 Sep 2026 04:05:59 +0000
Subject: [PATCH] [libc++][docs] Rename documentation files to Markdown (batch
 2)

---
 .../docs/DesignDocs/{NoexceptPolicy.rst => NoexceptPolicy.md}   | 0
 .../docs/DesignDocs/{PSTLIntegration.rst => PSTLIntegration.md} | 0
 .../{ThreadingSupportAPI.rst => ThreadingSupportAPI.md}         | 0
 libcxx/docs/DesignDocs/{TimeZone.rst => TimeZone.md}            | 0
 .../{UniquePtrTrivialAbi.rst => UniquePtrTrivialAbi.md}         | 0
 ...iorRandomization.rst => UnspecifiedBehaviorRandomization.md} | 0
 .../DesignDocs/{VisibilityMacros.rst => VisibilityMacros.md}    | 0
 .../docs/DesignDocs/{WindowsSupport.rst => WindowsSupport.md}   | 0
 libcxx/docs/{Hardening.rst => Hardening.md}                     | 0
 ...tionDefinedBehavior.rst => ImplementationDefinedBehavior.md} | 0
 libcxx/docs/{Modules.rst => Modules.md}                         | 0
 libcxx/docs/{TestingLibcxx.rst => TestingLibcxx.md}             | 0
 libcxx/docs/{UserDocumentation.rst => UserDocumentation.md}     | 0
 libcxx/docs/{VendorDocumentation.rst => VendorDocumentation.md} | 0
 libcxx/docs/conf.py                                             | 2 +-
 libcxx/docs/{index.rst => index.md}                             | 0
 libcxx/utils/libcxx-lit                                         | 2 +-
 17 files changed, 2 insertions(+), 2 deletions(-)
 rename libcxx/docs/DesignDocs/{NoexceptPolicy.rst => NoexceptPolicy.md} (100%)
 rename libcxx/docs/DesignDocs/{PSTLIntegration.rst => PSTLIntegration.md} (100%)
 rename libcxx/docs/DesignDocs/{ThreadingSupportAPI.rst => ThreadingSupportAPI.md} (100%)
 rename libcxx/docs/DesignDocs/{TimeZone.rst => TimeZone.md} (100%)
 rename libcxx/docs/DesignDocs/{UniquePtrTrivialAbi.rst => UniquePtrTrivialAbi.md} (100%)
 rename libcxx/docs/DesignDocs/{UnspecifiedBehaviorRandomization.rst => UnspecifiedBehaviorRandomization.md} (100%)
 rename libcxx/docs/DesignDocs/{VisibilityMacros.rst => VisibilityMacros.md} (100%)
 rename libcxx/docs/DesignDocs/{WindowsSupport.rst => WindowsSupport.md} (100%)
 rename libcxx/docs/{Hardening.rst => Hardening.md} (100%)
 rename libcxx/docs/{ImplementationDefinedBehavior.rst => ImplementationDefinedBehavior.md} (100%)
 rename libcxx/docs/{Modules.rst => Modules.md} (100%)
 rename libcxx/docs/{TestingLibcxx.rst => TestingLibcxx.md} (100%)
 rename libcxx/docs/{UserDocumentation.rst => UserDocumentation.md} (100%)
 rename libcxx/docs/{VendorDocumentation.rst => VendorDocumentation.md} (100%)
 rename libcxx/docs/{index.rst => index.md} (100%)

diff --git a/libcxx/docs/DesignDocs/NoexceptPolicy.rst b/libcxx/docs/DesignDocs/NoexceptPolicy.md
similarity index 100%
rename from libcxx/docs/DesignDocs/NoexceptPolicy.rst
rename to libcxx/docs/DesignDocs/NoexceptPolicy.md
diff --git a/libcxx/docs/DesignDocs/PSTLIntegration.rst b/libcxx/docs/DesignDocs/PSTLIntegration.md
similarity index 100%
rename from libcxx/docs/DesignDocs/PSTLIntegration.rst
rename to libcxx/docs/DesignDocs/PSTLIntegration.md
diff --git a/libcxx/docs/DesignDocs/ThreadingSupportAPI.rst b/libcxx/docs/DesignDocs/ThreadingSupportAPI.md
similarity index 100%
rename from libcxx/docs/DesignDocs/ThreadingSupportAPI.rst
rename to libcxx/docs/DesignDocs/ThreadingSupportAPI.md
diff --git a/libcxx/docs/DesignDocs/TimeZone.rst b/libcxx/docs/DesignDocs/TimeZone.md
similarity index 100%
rename from libcxx/docs/DesignDocs/TimeZone.rst
rename to libcxx/docs/DesignDocs/TimeZone.md
diff --git a/libcxx/docs/DesignDocs/UniquePtrTrivialAbi.rst b/libcxx/docs/DesignDocs/UniquePtrTrivialAbi.md
similarity index 100%
rename from libcxx/docs/DesignDocs/UniquePtrTrivialAbi.rst
rename to libcxx/docs/DesignDocs/UniquePtrTrivialAbi.md
diff --git a/libcxx/docs/DesignDocs/UnspecifiedBehaviorRandomization.rst b/libcxx/docs/DesignDocs/UnspecifiedBehaviorRandomization.md
similarity index 100%
rename from libcxx/docs/DesignDocs/UnspecifiedBehaviorRandomization.rst
rename to libcxx/docs/DesignDocs/UnspecifiedBehaviorRandomization.md
diff --git a/libcxx/docs/DesignDocs/VisibilityMacros.rst b/libcxx/docs/DesignDocs/VisibilityMacros.md
similarity index 100%
rename from libcxx/docs/DesignDocs/VisibilityMacros.rst
rename to libcxx/docs/DesignDocs/VisibilityMacros.md
diff --git a/libcxx/docs/DesignDocs/WindowsSupport.rst b/libcxx/docs/DesignDocs/WindowsSupport.md
similarity index 100%
rename from libcxx/docs/DesignDocs/WindowsSupport.rst
rename to libcxx/docs/DesignDocs/WindowsSupport.md
diff --git a/libcxx/docs/Hardening.rst b/libcxx/docs/Hardening.md
similarity index 100%
rename from libcxx/docs/Hardening.rst
rename to libcxx/docs/Hardening.md
diff --git a/libcxx/docs/ImplementationDefinedBehavior.rst b/libcxx/docs/ImplementationDefinedBehavior.md
similarity index 100%
rename from libcxx/docs/ImplementationDefinedBehavior.rst
rename to libcxx/docs/ImplementationDefinedBehavior.md
diff --git a/libcxx/docs/Modules.rst b/libcxx/docs/Modules.md
similarity index 100%
rename from libcxx/docs/Modules.rst
rename to libcxx/docs/Modules.md
diff --git a/libcxx/docs/TestingLibcxx.rst b/libcxx/docs/TestingLibcxx.md
similarity index 100%
rename from libcxx/docs/TestingLibcxx.rst
rename to libcxx/docs/TestingLibcxx.md
diff --git a/libcxx/docs/UserDocumentation.rst b/libcxx/docs/UserDocumentation.md
similarity index 100%
rename from libcxx/docs/UserDocumentation.rst
rename to libcxx/docs/UserDocumentation.md
diff --git a/libcxx/docs/VendorDocumentation.rst b/libcxx/docs/VendorDocumentation.md
similarity index 100%
rename from libcxx/docs/VendorDocumentation.rst
rename to libcxx/docs/VendorDocumentation.md
diff --git a/libcxx/docs/conf.py b/libcxx/docs/conf.py
index 98aa52edd5d2e..729c5211f18a2 100644
--- a/libcxx/docs/conf.py
+++ b/libcxx/docs/conf.py
@@ -15,7 +15,7 @@
 
 from llvm_sphinx import *  # see llvm-project/utils/docs/README.md
 
-globals().update(common_conf(tags, markdown=Markdown.NEVER))
+globals().update(common_conf(tags, markdown=Markdown.ALWAYS))
 
 # -- General configuration -----------------------------------------------------
 
diff --git a/libcxx/docs/index.rst b/libcxx/docs/index.md
similarity index 100%
rename from libcxx/docs/index.rst
rename to libcxx/docs/index.md
diff --git a/libcxx/utils/libcxx-lit b/libcxx/utils/libcxx-lit
index 62b988dd4dead..e6597a6297672 100755
--- a/libcxx/utils/libcxx-lit
+++ b/libcxx/utils/libcxx-lit
@@ -50,7 +50,7 @@ fi
 
 if [[ "${type}" == "runtimes" ]]; then
         echo "N.B.: In a bootstrap build, lit needs a prefix to work correctly;"
-        echo "      See libcxx/docs/Testinglibcxx.rst for more information."
+        echo "      See libcxx/docs/TestingLibcxx.md for more information."
 fi
 "${CMAKE}" --build "${build_dir}" --target ${type}-test-depends
 "${build_dir}/bin/llvm-lit" ${@}



More information about the libcxx-commits mailing list