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

[Reid Kleckner via libcxx-commits]

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

>From 779191b71620cde902db3f14f7afe4f1fd065dc9 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
 1)

---
 libcxx/docs/{ABIGuarantees.rst => ABIGuarantees.md}           | 0
 libcxx/docs/{AddingNewCIJobs.rst => AddingNewCIJobs.md}       | 0
 libcxx/docs/{CodingGuidelines.rst => CodingGuidelines.md}     | 0
 libcxx/docs/{Contributing.rst => Contributing.md}             | 0
 .../{NewStandardProcedure.rst => NewStandardProcedure.md}     | 0
 .../{PostMeetingProcedure.rst => PostMeetingProcedure.md}     | 0
 .../{ReleaseProcedure.rst => ReleaseProcedure.md}             | 0
 .../docs/DesignDocs/{ABIVersioning.rst => ABIVersioning.md}   | 0
 libcxx/docs/DesignDocs/{AtomicDesign.rst => AtomicDesign.md}  | 0
 .../{CapturingConfigInfo.rst => CapturingConfigInfo.md}       | 0
 .../{ExperimentalFeatures.rst => ExperimentalFeatures.md}     | 0
 .../{ExtendedCXX03Support.rst => ExtendedCXX03Support.md}     | 0
 .../{FeatureTestMacros.rst => FeatureTestMacros.md}           | 0
 libcxx/docs/DesignDocs/{FileTimeType.rst => FileTimeType.md}  | 0
 .../{HeaderRemovalPolicy.rst => HeaderRemovalPolicy.md}       | 0
 libcxx/docs/conf.py                                           | 2 +-
 libcxx/include/__configuration/abi.h                          | 4 ++--
 17 files changed, 3 insertions(+), 3 deletions(-)
 rename libcxx/docs/{ABIGuarantees.rst => ABIGuarantees.md} (100%)
 rename libcxx/docs/{AddingNewCIJobs.rst => AddingNewCIJobs.md} (100%)
 rename libcxx/docs/{CodingGuidelines.rst => CodingGuidelines.md} (100%)
 rename libcxx/docs/{Contributing.rst => Contributing.md} (100%)
 rename libcxx/docs/Contributing/{NewStandardProcedure.rst => NewStandardProcedure.md} (100%)
 rename libcxx/docs/Contributing/{PostMeetingProcedure.rst => PostMeetingProcedure.md} (100%)
 rename libcxx/docs/Contributing/{ReleaseProcedure.rst => ReleaseProcedure.md} (100%)
 rename libcxx/docs/DesignDocs/{ABIVersioning.rst => ABIVersioning.md} (100%)
 rename libcxx/docs/DesignDocs/{AtomicDesign.rst => AtomicDesign.md} (100%)
 rename libcxx/docs/DesignDocs/{CapturingConfigInfo.rst => CapturingConfigInfo.md} (100%)
 rename libcxx/docs/DesignDocs/{ExperimentalFeatures.rst => ExperimentalFeatures.md} (100%)
 rename libcxx/docs/DesignDocs/{ExtendedCXX03Support.rst => ExtendedCXX03Support.md} (100%)
 rename libcxx/docs/DesignDocs/{FeatureTestMacros.rst => FeatureTestMacros.md} (100%)
 rename libcxx/docs/DesignDocs/{FileTimeType.rst => FileTimeType.md} (100%)
 rename libcxx/docs/DesignDocs/{HeaderRemovalPolicy.rst => HeaderRemovalPolicy.md} (100%)

diff --git a/libcxx/docs/ABIGuarantees.rst b/libcxx/docs/ABIGuarantees.md
similarity index 100%
rename from libcxx/docs/ABIGuarantees.rst
rename to libcxx/docs/ABIGuarantees.md
diff --git a/libcxx/docs/AddingNewCIJobs.rst b/libcxx/docs/AddingNewCIJobs.md
similarity index 100%
rename from libcxx/docs/AddingNewCIJobs.rst
rename to libcxx/docs/AddingNewCIJobs.md
diff --git a/libcxx/docs/CodingGuidelines.rst b/libcxx/docs/CodingGuidelines.md
similarity index 100%
rename from libcxx/docs/CodingGuidelines.rst
rename to libcxx/docs/CodingGuidelines.md
diff --git a/libcxx/docs/Contributing.rst b/libcxx/docs/Contributing.md
similarity index 100%
rename from libcxx/docs/Contributing.rst
rename to libcxx/docs/Contributing.md
diff --git a/libcxx/docs/Contributing/NewStandardProcedure.rst b/libcxx/docs/Contributing/NewStandardProcedure.md
similarity index 100%
rename from libcxx/docs/Contributing/NewStandardProcedure.rst
rename to libcxx/docs/Contributing/NewStandardProcedure.md
diff --git a/libcxx/docs/Contributing/PostMeetingProcedure.rst b/libcxx/docs/Contributing/PostMeetingProcedure.md
similarity index 100%
rename from libcxx/docs/Contributing/PostMeetingProcedure.rst
rename to libcxx/docs/Contributing/PostMeetingProcedure.md
diff --git a/libcxx/docs/Contributing/ReleaseProcedure.rst b/libcxx/docs/Contributing/ReleaseProcedure.md
similarity index 100%
rename from libcxx/docs/Contributing/ReleaseProcedure.rst
rename to libcxx/docs/Contributing/ReleaseProcedure.md
diff --git a/libcxx/docs/DesignDocs/ABIVersioning.rst b/libcxx/docs/DesignDocs/ABIVersioning.md
similarity index 100%
rename from libcxx/docs/DesignDocs/ABIVersioning.rst
rename to libcxx/docs/DesignDocs/ABIVersioning.md
diff --git a/libcxx/docs/DesignDocs/AtomicDesign.rst b/libcxx/docs/DesignDocs/AtomicDesign.md
similarity index 100%
rename from libcxx/docs/DesignDocs/AtomicDesign.rst
rename to libcxx/docs/DesignDocs/AtomicDesign.md
diff --git a/libcxx/docs/DesignDocs/CapturingConfigInfo.rst b/libcxx/docs/DesignDocs/CapturingConfigInfo.md
similarity index 100%
rename from libcxx/docs/DesignDocs/CapturingConfigInfo.rst
rename to libcxx/docs/DesignDocs/CapturingConfigInfo.md
diff --git a/libcxx/docs/DesignDocs/ExperimentalFeatures.rst b/libcxx/docs/DesignDocs/ExperimentalFeatures.md
similarity index 100%
rename from libcxx/docs/DesignDocs/ExperimentalFeatures.rst
rename to libcxx/docs/DesignDocs/ExperimentalFeatures.md
diff --git a/libcxx/docs/DesignDocs/ExtendedCXX03Support.rst b/libcxx/docs/DesignDocs/ExtendedCXX03Support.md
similarity index 100%
rename from libcxx/docs/DesignDocs/ExtendedCXX03Support.rst
rename to libcxx/docs/DesignDocs/ExtendedCXX03Support.md
diff --git a/libcxx/docs/DesignDocs/FeatureTestMacros.rst b/libcxx/docs/DesignDocs/FeatureTestMacros.md
similarity index 100%
rename from libcxx/docs/DesignDocs/FeatureTestMacros.rst
rename to libcxx/docs/DesignDocs/FeatureTestMacros.md
diff --git a/libcxx/docs/DesignDocs/FileTimeType.rst b/libcxx/docs/DesignDocs/FileTimeType.md
similarity index 100%
rename from libcxx/docs/DesignDocs/FileTimeType.rst
rename to libcxx/docs/DesignDocs/FileTimeType.md
diff --git a/libcxx/docs/DesignDocs/HeaderRemovalPolicy.rst b/libcxx/docs/DesignDocs/HeaderRemovalPolicy.md
similarity index 100%
rename from libcxx/docs/DesignDocs/HeaderRemovalPolicy.rst
rename to libcxx/docs/DesignDocs/HeaderRemovalPolicy.md
diff --git a/libcxx/docs/conf.py b/libcxx/docs/conf.py
index 98aa52edd5d2e2..729c5211f18a26 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/include/__configuration/abi.h b/libcxx/include/__configuration/abi.h
index 757ba69cb17b41..a3a6069e242352 100644
--- a/libcxx/include/__configuration/abi.h
+++ b/libcxx/include/__configuration/abi.h
@@ -50,12 +50,12 @@
 #endif
 
 #if _LIBCPP_ABI_VERSION >= 2
-// TODO: Move the description of the remaining ABI flags to ABIGuarantees.rst or remove them.
+// TODO: Move the description of the remaining ABI flags to ABIGuarantees.md or remove them.
 
 // According to the Standard, `bitset::operator[] const` returns bool
 #  define _LIBCPP_ABI_BITSET_VECTOR_BOOL_CONST_SUBSCRIPT_RETURN_BOOL
 
-// These flags are documented in ABIGuarantees.rst
+// These flags are documented in ABIGuarantees.md
 #  define _LIBCPP_ABI_ALTERNATE_STRING_LAYOUT
 #  define _LIBCPP_ABI_ATOMIC_WAIT_NATIVE_BY_SIZE
 #  define _LIBCPP_ABI_ENABLE_SHARED_PTR_TRIVIAL_ABI