[libcxx-commits] [libcxx] [libc++][docs] Rename generated feature-test documentation to Markdown (PR #222063)

Reid Kleckner via libcxx-commits libcxx-commits at lists.llvm.org
Sat Sep 19 17:10:50 PDT 2026


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

>From 830cbf39cfef9b961a798078c0e9f7703ea6658b 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 generated and status table
 documentation to Markdown

---
 .../{FeatureTestMacroTable.rst => FeatureTestMacroTable.md}   | 0
 libcxx/docs/Helpers/{Styles.rst => Styles.md}                 | 0
 libcxx/docs/Status/{Cxx17.rst => Cxx17.md}                    | 2 +-
 libcxx/docs/Status/{Cxx20.rst => Cxx20.md}                    | 2 +-
 libcxx/docs/Status/{Cxx23.rst => Cxx23.md}                    | 4 ++--
 libcxx/docs/Status/{Cxx26.rst => Cxx26.md}                    | 2 +-
 libcxx/docs/Status/{Cxx29.rst => Cxx29.md}                    | 2 +-
 libcxx/docs/conf.py                                           | 2 +-
 libcxx/utils/generate_feature_test_macro_components.py        | 2 +-
 9 files changed, 8 insertions(+), 8 deletions(-)
 rename libcxx/docs/{FeatureTestMacroTable.rst => FeatureTestMacroTable.md} (100%)
 rename libcxx/docs/Helpers/{Styles.rst => Styles.md} (100%)
 rename libcxx/docs/Status/{Cxx17.rst => Cxx17.md} (96%)
 rename libcxx/docs/Status/{Cxx20.rst => Cxx20.md} (96%)
 rename libcxx/docs/Status/{Cxx23.rst => Cxx23.md} (95%)
 rename libcxx/docs/Status/{Cxx26.rst => Cxx26.md} (96%)
 rename libcxx/docs/Status/{Cxx29.rst => Cxx29.md} (96%)

diff --git a/libcxx/docs/FeatureTestMacroTable.rst b/libcxx/docs/FeatureTestMacroTable.md
similarity index 100%
rename from libcxx/docs/FeatureTestMacroTable.rst
rename to libcxx/docs/FeatureTestMacroTable.md
diff --git a/libcxx/docs/Helpers/Styles.rst b/libcxx/docs/Helpers/Styles.md
similarity index 100%
rename from libcxx/docs/Helpers/Styles.rst
rename to libcxx/docs/Helpers/Styles.md
diff --git a/libcxx/docs/Status/Cxx17.rst b/libcxx/docs/Status/Cxx17.md
similarity index 96%
rename from libcxx/docs/Status/Cxx17.rst
rename to libcxx/docs/Status/Cxx17.md
index e0ac2cb5c3600..337c422212f6b 100644
--- a/libcxx/docs/Status/Cxx17.rst
+++ b/libcxx/docs/Status/Cxx17.md
@@ -4,7 +4,7 @@
 libc++ C++17 Status
 ================================
 
-.. include:: ../Helpers/Styles.rst
+.. include:: ../Helpers/Styles.md
 
 .. contents::
    :local:
diff --git a/libcxx/docs/Status/Cxx20.rst b/libcxx/docs/Status/Cxx20.md
similarity index 96%
rename from libcxx/docs/Status/Cxx20.rst
rename to libcxx/docs/Status/Cxx20.md
index 3b1241cd07e47..3fa951a233647 100644
--- a/libcxx/docs/Status/Cxx20.rst
+++ b/libcxx/docs/Status/Cxx20.md
@@ -4,7 +4,7 @@
 libc++ C++20 Status
 ================================
 
-.. include:: ../Helpers/Styles.rst
+.. include:: ../Helpers/Styles.md
 
 .. contents::
    :local:
diff --git a/libcxx/docs/Status/Cxx23.rst b/libcxx/docs/Status/Cxx23.md
similarity index 95%
rename from libcxx/docs/Status/Cxx23.rst
rename to libcxx/docs/Status/Cxx23.md
index 0f9d4bf0d1af8..faf6a56902ff2 100644
--- a/libcxx/docs/Status/Cxx23.rst
+++ b/libcxx/docs/Status/Cxx23.md
@@ -4,7 +4,7 @@
 libc++ C++23 Status
 ================================
 
-.. include:: ../Helpers/Styles.rst
+.. include:: ../Helpers/Styles.md
 
 .. contents::
    :local:
@@ -40,4 +40,4 @@ Library Working Group Issues Status
 .. csv-table::
    :file: Cxx23Issues.csv
    :header-rows: 1
-   :widths: auto
\ No newline at end of file
+   :widths: auto
diff --git a/libcxx/docs/Status/Cxx26.rst b/libcxx/docs/Status/Cxx26.md
similarity index 96%
rename from libcxx/docs/Status/Cxx26.rst
rename to libcxx/docs/Status/Cxx26.md
index 014e6f1b9a3e2..6e37608ee7338 100644
--- a/libcxx/docs/Status/Cxx26.rst
+++ b/libcxx/docs/Status/Cxx26.md
@@ -4,7 +4,7 @@
 libc++ C++26 Status
 ================================
 
-.. include:: ../Helpers/Styles.rst
+.. include:: ../Helpers/Styles.md
 
 .. contents::
    :local:
diff --git a/libcxx/docs/Status/Cxx29.rst b/libcxx/docs/Status/Cxx29.md
similarity index 96%
rename from libcxx/docs/Status/Cxx29.rst
rename to libcxx/docs/Status/Cxx29.md
index e4227dfa84cc4..d94a70b36b988 100644
--- a/libcxx/docs/Status/Cxx29.rst
+++ b/libcxx/docs/Status/Cxx29.md
@@ -4,7 +4,7 @@
 libc++ C++29 Status
 ================================
 
-.. include:: ../Helpers/Styles.rst
+.. include:: ../Helpers/Styles.md
 
 .. contents::
    :local:
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/utils/generate_feature_test_macro_components.py b/libcxx/utils/generate_feature_test_macro_components.py
index 8cc54971c57c9..a6502286ed552 100755
--- a/libcxx/utils/generate_feature_test_macro_components.py
+++ b/libcxx/utils/generate_feature_test_macro_components.py
@@ -2125,7 +2125,7 @@ def produce_docs():
         status_tables=create_table(get_status_table(), 4)
     )
 
-    table_doc_path = os.path.join(docs_path, "FeatureTestMacroTable.rst")
+    table_doc_path = os.path.join(docs_path, "FeatureTestMacroTable.md")
     with open(table_doc_path, "w", newline="\n") as f:
         f.write(doc_str)
 



More information about the libcxx-commits mailing list