From patchwork Wed Jan 31 09:48:32 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Wakely X-Patchwork-Id: 194662 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2087:b0:106:209c:c626 with SMTP id gs7csp1803621dyb; Wed, 31 Jan 2024 02:54:30 -0800 (PST) X-Google-Smtp-Source: AGHT+IHLbjnAgdqDzM9XlDoG+mtMWJ1mxqQv1LeuuDDg8Hb1fKOTMGDQ0cR44QMmXls/F7mF7S4R X-Received: by 2002:a05:620a:3841:b0:783:997a:545b with SMTP id po1-20020a05620a384100b00783997a545bmr993545qkn.4.1706698469893; Wed, 31 Jan 2024 02:54:29 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1706698469; cv=pass; d=google.com; s=arc-20160816; b=MhNh3HF3QnYiKv4BAD1g0/paB68D5AjXrJ3IXk7keLFXyq0P6mZ0LezX+UifrhYFGE XAtGgALJcE6POL1RaCnPg/zqOASXSO4PGheycsCKN/lCxI5VIvDt3a05k/kBxRW+8yiY PZ72Xmqf3kTMu9DTcZsUbe9YMQpiy+MJBSLbSW4r1k10bmhRC7TkhvIeI/O8/pBg3W41 T5auXY4nfWpFDDnMJfegReEG48UDwBw3jcRdUBaX0dAPshHD4Y3eRhd/ZvFQa/bcFUfw 0oZ3D1mwK3DsNacqX0nsSusoiKDphOz31sbcd607P4lnK0Xmg0joNTgsr94m+tDBTF86 zGCQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:content-transfer-encoding :mime-version:message-id:date:subject:to:from:dkim-signature :arc-filter:dmarc-filter:delivered-to; bh=7XX3lrwg8E/F9QlzqDY14PfzHswqMXP6jQnreZyapjU=; fh=V4aUBGptbnbNYvLrsRhAWoYfnc/b62T1lZ2kqosGxRY=; b=vCBKzH7dwevQ7CHsAaDQl1ubSo1BR1uHtJrzICDm27Nt8XzZx7bm5d+4SCkkzubDqB XvBhUnip3meEDBzGooOCo7FZXbzMpMXxcjOAj9AkeN3BA7hG/tw/IJWn+8QjdNX9mNor FnRcf+shgk+Jmq4TUa5rL2VdK7gvtZtkk74lvexpKyqWQE6xuf8u2SV9I92f73da+978 7+jkyYGZlRy4WfmpmoX1PJDyRv52FlGBlXLG868S1jLAyNZVlQrjBO7N3YSg5HowKvxT rWHhccETpUyxJpwYjcodcZnx10njhFLWHdI7/FLiOdgG1XMniwXlqDgeCUsSXfFrbbgm q2Ag==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@redhat.com header.s=mimecast20190719 header.b=XSQOT6v6; arc=pass (i=1); 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=redhat.com X-Forwarded-Encrypted: i=1; AJvYcCWa/u+OXnpDT/ik1tWgktc2ccOD5Oskq0wDCfyOOIUndu5XWJTIhXH57K7HYGfjHCNeMaZ2zh432ih0x5GSl+ooJ3hR9w== Received: from server2.sourceware.org (server2.sourceware.org. [8.43.85.97]) by mx.google.com with ESMTPS id h22-20020a05620a13f600b007853f73688fsi183112qkl.40.2024.01.31.02.54.29 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 31 Jan 2024 02:54:29 -0800 (PST) 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=@redhat.com header.s=mimecast20190719 header.b=XSQOT6v6; arc=pass (i=1); 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=redhat.com Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 294BF386102E for ; Wed, 31 Jan 2024 09:51:20 +0000 (GMT) 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.133.124]) by sourceware.org (Postfix) with ESMTPS id D4798385828C for ; Wed, 31 Jan 2024 09:49:27 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org D4798385828C Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org D4798385828C Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=170.10.133.124 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1706694570; cv=none; b=FsYtfWCZsvGz06k1DHAs6zL96uKGw3IYN2WVZM0trLccWpobVL52px7FWcw/ctZDbRk2i5FTxxvkZ+XMIO5Zskm8QZoNwWeg/UuRrbOSR+20MEQdzvAotfuMwzpLYyGEh86avrJqQ5OTYY5zbPJoeUUFTS4KN9E234+Gafh/Se0= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1706694570; c=relaxed/simple; bh=LqwIy8wKdBBstjdQQfnfzlSRTEpOknHAO11irJDBcOo=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=PdhVkSTyK1X4PRKu4ewLWVFaLrNfKfZXUVAI5qhIwlU1bXoWxr+Zt8StZaGyaMu5T7GMTCBAgt46A/JuojtprQudyJY6FIGV73OePYfLD51gw7G2KYMboIfHKiMzWFWodQvvaFo76dc9Al6BUHsr1PmUVLQpAAUa1MumkOOMKJg= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1706694567; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=7XX3lrwg8E/F9QlzqDY14PfzHswqMXP6jQnreZyapjU=; b=XSQOT6v6Rmjn6pjJXPpeIZydiYIhFaD5rwknFk5Zhqzn2xWRKMoGr+65G+zGNr54jmcPTV Qzd7vLe6uYgi6nWtPNlV53Eq/oq1f6eNBoKbBQRjn2hqfi0DWM/xkPJjtqA08tG3qUYKjD BIXE7rWcBhgFjMG7eLbKE3+C7r8eljg= Received: from mimecast-mx02.redhat.com (mx-ext.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-620-Tle4OtIwNkGGNwZRs_AKgQ-1; Wed, 31 Jan 2024 04:49:25 -0500 X-MC-Unique: Tle4OtIwNkGGNwZRs_AKgQ-1 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.rdu2.redhat.com [10.11.54.3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id AC7912806664; Wed, 31 Jan 2024 09:49:24 +0000 (UTC) Received: from localhost (unknown [10.42.28.13]) by smtp.corp.redhat.com (Postfix) with ESMTP id 7969C1121306; Wed, 31 Jan 2024 09:49:24 +0000 (UTC) From: Jonathan Wakely To: libstdc++@gcc.gnu.org, gcc-patches@gcc.gnu.org Subject: [committed] libstdc++: Add all supported headers to lists in the manual Date: Wed, 31 Jan 2024 09:48:32 +0000 Message-ID: <20240131094923.1912937-1-jwakely@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.4.1 on 10.11.54.3 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com X-Spam-Status: No, score=-12.7 required=5.0 tests=BAYES_00, DKIMWL_WL_HIGH, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H3, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_NONE, TXREP, T_SCC_BODY_TEXT_LINE autolearn=unavailable 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.30 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces+ouuuleilei=gmail.com@gcc.gnu.org X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1789603054635503298 X-GMAIL-MSGID: 1789603054635503298 Another piece of the manual that needs to be kept up to date as we add features. Pushed to trunk. -- >8 -- libstdc++-v3/ChangeLog: * doc/xml/manual/using.xml: Update tables of supported headers. * doc/html/*: Regenerate. --- libstdc++-v3/doc/html/manual/index.html | 2 +- .../doc/html/manual/using_headers.html | 58 ++++-- libstdc++-v3/doc/xml/manual/using.xml | 165 ++++++++++++++++-- 3 files changed, 192 insertions(+), 33 deletions(-) diff --git a/libstdc++-v3/doc/xml/manual/using.xml b/libstdc++-v3/doc/xml/manual/using.xml index 7276cad0feb..b3b0c368e44 100644 --- a/libstdc++-v3/doc/xml/manual/using.xml +++ b/libstdc++-v3/doc/xml/manual/using.xml @@ -468,9 +468,9 @@ Unless specified otherwise below, they are also available in later modes -shows the C++2a include files. -These are available in C++2a compilation -mode, i.e. -std=c++2a or -std=gnu++2a. +shows the C++20 include files. +These are available in C++20 compilation +mode, i.e. -std=c++20 or -std=gnu++20. Including these headers in earlier modes will not result in compilation errors, but will not define anything. +barrier bit -version +charconv +compare +concepts + + +coroutine +format +latch +numbers +ranges + + +semaphore +source_location +span +stop_token +syncstream + + +version + - - The following headers have been removed in the C++2a working draft. + The following headers have been removed in the C++20 standard. They are still available when using this implementation, but in future - they might start to produce warnings or errors when included in C++2a mode. + they might start to produce warnings or errors when included in C++20 mode. Programs that intend to be portable should not include them. @@ -529,10 +547,86 @@ Unless specified otherwise below, they are also available in later modes + + +shows the C++23 include files. +These are available in C++23 compilation +mode, i.e. -std=c++23 or -std=gnu++23. +Including these headers in earlier modes will not result in +compilation errors, but will not define anything. + + + + + +C++ 2023 Library Headers + + + + + + + + + +expected +generator +print +spanstream +stacktrace + + +stdatomic.h +stdfloat + + + + + +
+ + + +shows the C++26 include files. +These are available in C++26 compilation +mode, i.e. -std=c++26 or -std=gnu++26. +Including these headers in earlier modes will not result in +compilation errors, but will not define anything. + + + + + +C++ 2026 Library Headers + + + + + + +text_encoding + + + + +
+ + , shows the additional include file define by the -File System Technical Specification, ISO/IEC TS 18822. +File System Technical Specification, ISO/IEC TS 18822:2015. This is available in C++11 and later compilation modes. Including this header in earlier modes will not result in compilation errors, but will not define anything. @@ -556,8 +650,11 @@ compilation errors, but will not define anything. , shows the additional include files define by the C++ Extensions for -Library Fundamentals Technical Specification, ISO/IEC TS 19568. -These are available in C++14 and later compilation modes. +Library Fundamentals Technical Specification, ISO/IEC TS 19568:2015, +ISO/IEC TS 19568:2017, and ISO/IEC TS 19568:2024. +These are available in C++14 and later compilation modes, except for +<experimental/scope> +which is available in C++20 and later compilation modes. Including these headers in earlier modes will not result in compilation errors, but will not define anything. @@ -598,22 +695,58 @@ compilation errors, but will not define anything. experimental/random experimental/ratio experimental/regex +experimental/scope experimental/set -experimental/source_location +experimental/source_location experimental/string experimental/string_view experimental/system_error experimental/tuple -experimental/type_traits +experimental/type_traits experimental/unordered_map experimental/unordered_set experimental/utility experimental/vector - + + + + + + + +, +shows the additional include files define by the +Networking Technical Specification, ISO/IEC TS 19216:2018. +These are available in C++14 and later compilation modes. +Including these headers in earlier modes will not result in +compilation errors, but will not define anything. + + + + +Networking TS Headers + + + + + + + + +experimental/buffer +experimental/executor +experimental/internet +experimental/io_context + + +experimental/net +experimental/netfwd +experimental/socket +experimental/timer