From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 2181) id 5E971395B403; Mon, 19 Apr 2021 09:08:38 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 5E971395B403 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset="utf-8" From: Jonathan Wakely To: gcc-cvs@gcc.gnu.org, libstdc++-cvs@gcc.gnu.org Subject: [gcc r8-10848] libstdc++: Document when C++11/14/17 support became stable [PR 99058] X-Act-Checkin: gcc X-Git-Author: Jonathan Wakely X-Git-Refname: refs/heads/releases/gcc-8 X-Git-Oldrev: c8a9681d74adf5c2c396229270e33c7d8fb765d7 X-Git-Newrev: 07b4b069b34262b77e4295e57351bad49f3c4d06 Message-Id: <20210419090838.5E971395B403@sourceware.org> Date: Mon, 19 Apr 2021 09:08:38 +0000 (GMT) X-BeenThere: libstdc++-cvs@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Libstdc++-cvs mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Apr 2021 09:08:38 -0000 https://gcc.gnu.org/g:07b4b069b34262b77e4295e57351bad49f3c4d06 commit r8-10848-g07b4b069b34262b77e4295e57351bad49f3c4d06 Author: Jonathan Wakely Date: Thu Feb 11 15:35:23 2021 +0000 libstdc++: Document when C++11/14/17 support became stable [PR 99058] libstdc++-v3/ChangeLog: PR libstdc++/99058 * doc/xml/manual/status_cxx2011.xml: Document when support became stable. * doc/xml/manual/status_cxx2014.xml: Likewise. * doc/xml/manual/status_cxx2017.xml: Likewise. * doc/html/manual/status.html: Regenerate. (cherry picked from commit ce43c906049b828c0472d8499b52ac6233c869d0) Diff: --- libstdc++-v3/doc/html/manual/status.html | 8 ++++++++ libstdc++-v3/doc/xml/manual/status_cxx2011.xml | 3 +++ libstdc++-v3/doc/xml/manual/status_cxx2014.xml | 3 +++ libstdc++-v3/doc/xml/manual/status_cxx2017.xml | 2 ++ 4 files changed, 16 insertions(+) diff --git a/libstdc++-v3/doc/html/manual/status.html b/libstdc++-v3/doc/html/manual/status.html index 189b4e5eda2..ce10dd6c108 100644 --- a/libstdc++-v3/doc/html/manual/status.html +++ b/libstdc++-v3/doc/html/manual/status.html @@ -153,6 +153,9 @@ features. See __cplusplus is used to check for the presence of the required flag. +GCC 5.1 was the first release with non-experimental C++11 support, +so the API and ABI of features added in C++11 is only stable +since that release.

This page describes the C++11 support in the GCC 8 series.

Table 1.2. C++ 2011 Implementation Status

SectionDescriptionStatusComments
@@ -385,6 +388,9 @@ features. See __cplusplus is used to check for the presence of the required flag. +GCC 6.1 was the first release with non-experimental C++14 support, +so the API and ABI of features added in C++14 is only stable +since that release.

This page describes the C++14 and library TS support in the GCC 8 series.

Table 1.3. C++ 2014 Implementation Status

PaperTitleStatusComments
@@ -519,6 +525,8 @@ features. See __cplusplus is used to check for the presence of the required flag. +C++17 support is experimental up to and including the GCC 8 series, +so the API and ABI of features added in C++17 is not stable in those releases.

This section describes the C++17 and library TS support in the GCC 8 series.

diff --git a/libstdc++-v3/doc/xml/manual/status_cxx2011.xml b/libstdc++-v3/doc/xml/manual/status_cxx2011.xml index fd07f574ecb..466699e605c 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxx2011.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxx2011.xml @@ -24,6 +24,9 @@ features. See dialect options. The pre-defined symbol __cplusplus is used to check for the presence of the required flag. +GCC 5.1 was the first release with non-experimental C++11 support, +so the API and ABI of features added in C++11 is only stable +since that release. diff --git a/libstdc++-v3/doc/xml/manual/status_cxx2014.xml b/libstdc++-v3/doc/xml/manual/status_cxx2014.xml index ee0836ee8ef..131e67b700f 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxx2014.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxx2014.xml @@ -17,6 +17,9 @@ features. See dialect options. The pre-defined symbol __cplusplus is used to check for the presence of the required flag. +GCC 6.1 was the first release with non-experimental C++14 support, +so the API and ABI of features added in C++14 is only stable +since that release. diff --git a/libstdc++-v3/doc/xml/manual/status_cxx2017.xml b/libstdc++-v3/doc/xml/manual/status_cxx2017.xml index 3931a7a71f9..49ecc8df8b4 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxx2017.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxx2017.xml @@ -17,6 +17,8 @@ features. See dialect options. The pre-defined symbol __cplusplus is used to check for the presence of the required flag. +C++17 support is experimental up to and including the GCC 8 series, +so the API and ABI of features added in C++17 is not stable in those releases.