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

via libcxx-commits libcxx-commits at lists.llvm.org
Tue Sep 8 14:50:42 PDT 2026


llvmorg-github-actions[bot] wrote:


<!--LLVM PR SUMMARY COMMENT-->

@llvm/pr-subscribers-libcxx

Author: Reid Kleckner (rnk)

<details>
<summary>Changes</summary>

Tracking issue: #<!-- -->201242
See the [migration guide] for more information. 

[migration guide]: https://llvm.org/docs/SphinxQuickstartTemplate.html#markdown-migration-guidelines

This is the initial straight rename commit. It will probably break the docs build, but it has to be a separate PR for blame preservation purposes.


---
Full diff: https://github.com/llvm/llvm-project/pull/222062.diff


17 Files Affected:

- (renamed) libcxx/docs/DesignDocs/NoexceptPolicy.md () 
- (renamed) libcxx/docs/DesignDocs/PSTLIntegration.md () 
- (renamed) libcxx/docs/DesignDocs/ThreadingSupportAPI.md () 
- (renamed) libcxx/docs/DesignDocs/TimeZone.md () 
- (renamed) libcxx/docs/DesignDocs/UniquePtrTrivialAbi.md () 
- (renamed) libcxx/docs/DesignDocs/UnspecifiedBehaviorRandomization.md () 
- (renamed) libcxx/docs/DesignDocs/VisibilityMacros.md () 
- (renamed) libcxx/docs/DesignDocs/WindowsSupport.md () 
- (renamed) libcxx/docs/Hardening.md () 
- (renamed) libcxx/docs/ImplementationDefinedBehavior.md () 
- (renamed) libcxx/docs/Modules.md () 
- (renamed) libcxx/docs/TestingLibcxx.md () 
- (renamed) libcxx/docs/UserDocumentation.md () 
- (renamed) libcxx/docs/VendorDocumentation.md () 
- (modified) libcxx/docs/conf.py (+1-1) 
- (renamed) libcxx/docs/index.md () 
- (modified) libcxx/utils/libcxx-lit (+1-1) 


``````````diff
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" ${@}

``````````

</details>


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


More information about the libcxx-commits mailing list