From patchwork Wed Mar 22 10:42:30 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Wakely X-Patchwork-Id: 73342 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:604a:0:0:0:0:0 with SMTP id j10csp2268026wrt; Wed, 22 Mar 2023 03:43:17 -0700 (PDT) X-Google-Smtp-Source: AK7set/C+tWixkodG5gSNcpxFM7a+5TlVWhxPSCQ9CD7jHGW+ORTQ4+QRvbjmuRVL/keUQFyrT3v X-Received: by 2002:a17:906:95d7:b0:92f:abff:b4cc with SMTP id n23-20020a17090695d700b0092fabffb4ccmr5871460ejy.77.1679481797269; Wed, 22 Mar 2023 03:43:17 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1679481797; cv=none; d=google.com; s=arc-20160816; b=zzJRTeZs5tTVmgzLmNGNopRa+qbX3YM3MYbzJhNQQEojVFFiX+Cx0yOccpgx70utNM JmVx6Xtt1LWJ2/KadLUjEEB/mP2pX1IYbtJDR6I1s9b+jVOooLEsW0drOV2ya6oYz3vY yFt8h/wFZ0hSH9dVqe0HtMkCu62ylvUfpfOA2DhmGM0XmSobYAMlhpG2r0+I7yMC1sVW FUbalnvNDi8MmJmbUp3AWMwtuMrexb5jU30MmtnliMhTUZ+xdiS3aj2CYPfQWfZQCvTm yfFAnkGCB/gVSvOqIrrIfQaRHcu0jSoAtyDDsM0qdW+t/DFIkXDKeducUlNwmW/E/I+u /Olw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:reply-to:from:list-subscribe:list-help:list-post :list-archive:list-unsubscribe:list-id:precedence :content-transfer-encoding:mime-version:message-id:date:subject:cc :to:dmarc-filter:delivered-to:dkim-signature:dkim-filter; bh=3hJVELbvIbodGmFqwvrL4qN+lIh0DSYezPOTTDbYkNE=; b=XrRsbYyqIl0q4gnhF43xplhcEYaspaXXuFPTCgFQvY9lekCYHia7iihwc4QsbOzzVP m7UlltkhMx08lPW9q8wfy20XSkZiUaog6NlcUgRCBQG2/2oAj6+VMy1/DN5+PnzZuPIu aswlMll5QmEg4EwI2GhTbjbLZBMPPOlqWD/8TLMOawgtHuyI75aGtH+FFxez0fcPkUV8 CuisS9u8QDQdzIYagC0uKZ23jAT5cjHN/XnNMWx28DXeE2uA9X3ZNB1lXe12LGRqmSzC YAx1euYEF6UE6o+8+rkckSpNGzUtNeSrWmlQ5XiraH/AH2lKyKKX7tE/5biRdQiam5DC wKvg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gcc.gnu.org header.s=default header.b=YW7KrmsH; spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=gnu.org Received: from sourceware.org (ip-8-43-85-97.sourceware.org. [8.43.85.97]) by mx.google.com with ESMTPS id ay5-20020a170906d28500b008e10c06e930si14355044ejb.549.2023.03.22.03.43.17 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 22 Mar 2023 03:43:17 -0700 (PDT) Received-SPF: pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) client-ip=8.43.85.97; Authentication-Results: mx.google.com; dkim=pass header.i=@gcc.gnu.org header.s=default header.b=YW7KrmsH; spf=pass (google.com: domain of gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org designates 8.43.85.97 as permitted sender) smtp.mailfrom="gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=gnu.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 578EC3858436 for ; Wed, 22 Mar 2023 10:43:16 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 578EC3858436 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1679481796; bh=3hJVELbvIbodGmFqwvrL4qN+lIh0DSYezPOTTDbYkNE=; h=To:Cc:Subject:Date:List-Id:List-Unsubscribe:List-Archive: List-Post:List-Help:List-Subscribe:From:Reply-To:From; b=YW7KrmsHpEfp4ANZb5obFzoG3cHm174n0Bh2csmBsSGiJMR4isecpxx7FhHgbNIpj aHKoZCEWOS2W9IsgyAGNrKPX6+X3u6iCV+zD6/QXrV5NokqNwv8P9RpH5hUfNeYs89 273sKLJE7O9Fq0EIAM9vrK9QZjAuQcDrvXugu6Y8= X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by sourceware.org (Postfix) with ESMTPS id 6A0F8385840E for ; Wed, 22 Mar 2023 10:42:33 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 6A0F8385840E Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-287-tKYHHj0BMMOgGvek8WA0EQ-1; Wed, 22 Mar 2023 06:42:31 -0400 X-MC-Unique: tKYHHj0BMMOgGvek8WA0EQ-1 Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.rdu2.redhat.com [10.11.54.4]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 7819A1C02D31 for ; Wed, 22 Mar 2023 10:42:31 +0000 (UTC) Received: from localhost (unknown [10.33.36.149]) by smtp.corp.redhat.com (Postfix) with ESMTP id 36311202701E; Wed, 22 Mar 2023 10:42:31 +0000 (UTC) To: gcc-patches@gcc.gnu.org Cc: Jason Merrill , Marek Polacek Subject: [PATCH] wwwdocs: Clarify experimental status of C++17 prior to GCC 9 Date: Wed, 22 Mar 2023 10:42:30 +0000 Message-Id: <20230322104230.343644-1-jwakely@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.4 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com X-Spam-Status: No, score=-11.9 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, KAM_NUMSUBJECT, KAM_SHORT, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2, SPF_HELO_NONE, SPF_NONE, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Jonathan Wakely via Gcc-patches From: Jonathan Wakely Reply-To: Jonathan Wakely Errors-To: gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org Sender: "Gcc-patches" X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1761064305194933304?= X-GMAIL-MSGID: =?utf-8?q?1761064305194933304?= We don't currently have a single page where you can find out when support for a given standard became non-experimental (you have to look through all the gcc-X/changes.html pages to find it). I think we should have that info on the cxx-status.html page. This adds it for C++17, and we can do the same for C++20 when we declare that stable. OK for wwwdocs? -- >8 -- Also link to library docs for C++20 and add a cxx2a anchor which is used by some old links. --- htdocs/projects/cxx-status.html | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/htdocs/projects/cxx-status.html b/htdocs/projects/cxx-status.html index b5362bba..7f59e5a2 100644 --- a/htdocs/projects/cxx-status.html +++ b/htdocs/projects/cxx-status.html @@ -402,10 +402,12 @@ --> -

C++20 Support in GCC

+

C++20 Support in GCC

GCC has experimental support for the latest revision of the C++ - standard, which was published in 2020.

+ standard, which was published in 2020. + The status of C++20 library features is described in + the library documentation.

C++20 features are available since GCC 8. To enable C++20 support, add the command-line parameter -std=c++20 @@ -988,14 +990,16 @@

GCC has almost full support for the previous revision of the C++ standard, which was published in 2017. - Some library features are missing or incomplete, as described in + The status of C++17 library features is described in the library documentation.

-

C++17 features are available since GCC 5. This mode is the default - in GCC 11; it can be explicitly selected with the -std=c++17 - command-line flag, or -std=gnu++17 to enable GNU extensions - as well.

+

C++17 mode is the default since GCC 11; it can be explicitly selected + with the -std=c++17 command-line flag, or + -std=gnu++17 to enable GNU extensions as well. + Some C++17 features are available since GCC 5, but support was experimental + and the ABI of C++17 features was not stable until GCC 9. +

C++17 Language Features

@@ -1315,7 +1319,7 @@

GCC has full support for the of the 2014 C++ standard.

-

This mode is the default in GCC 6.1 up until GCC 10 (including); it can +

This mode is the default in GCC 6.1 up until GCC 10 (inclusive); it can be explicitly selected with the -std=c++14 command-line flag, or -std=gnu++14 to enable GNU extensions as well.