[libcxx-commits] [libcxx] [libc++] Document experimental features in the library (PR #65994)

[Louis Dionne via libcxx-commits]

https://github.com/ldionne created https://github.com/llvm/llvm-project/pull/65994:

Fixes #65125

>From a68df5d572ce09ef68fc62e4126dac8dc00b85b0 Mon Sep 17 00:00:00 2001
From: Louis Dionne <ldionne.2 at gmail.com>
Date: Mon, 11 Sep 2023 14:36:29 -0400
Subject: [PATCH] [libc++] Document experimental features in the library

Fixes #65125
---
 libcxx/docs/UsingLibcxx.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/libcxx/docs/UsingLibcxx.rst b/libcxx/docs/UsingLibcxx.rst
index 6136de9048947b0..3c208a13ce3409e 100644
--- a/libcxx/docs/UsingLibcxx.rst
+++ b/libcxx/docs/UsingLibcxx.rst
@@ -43,6 +43,13 @@ the Standard but whose implementation is not complete or stable yet in libc++. T
 are disabled by default because they are neither API nor ABI stable. However, the
 ``-fexperimental-library`` compiler flag can be defined to turn those features on.
 
+The following features are currently considered experimental and are only provided
+when ``-fexperimental-library`` is passed:
+
+* The parallel algorithms library (``<execution>`` and the associated algorithms)
+* ``std::stop_token``, ``std::stop_source`` and ``std::stop_callback``
+* ``std::chrono::tzdb`` and related time zone functionality
+
 .. warning::
   Experimental libraries are experimental.
     * The contents of the ``<experimental/...>`` headers and the associated static