From patchwork Sat Jun 1 09:58:36 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Jonathan Wakely X-Patchwork-Id: 1942407 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=LnOVgVSe; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org (client-ip=2620:52:3:1:0:246e:9693:128c; helo=server2.sourceware.org; envelope-from=gcc-patches-bounces+incoming=patchwork.ozlabs.org@gcc.gnu.org; receiver=patchwork.ozlabs.org) Received: from server2.sourceware.org (server2.sourceware.org [IPv6:2620:52:3:1:0:246e:9693:128c]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1) server-digest SHA384) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4VrwTD6VQPz20Pb for ; Sat, 1 Jun 2024 19:59:58 +1000 (AEST) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id D05A0388265A for ; Sat, 1 Jun 2024 09:59:56 +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 782EA3882120 for ; Sat, 1 Jun 2024 09:59:29 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 782EA3882120 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 782EA3882120 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=1717235971; cv=none; b=S1PUCJ/wg6J70gXAY8kd3ZGbhkaEgCumja5zXOtMGWAXDHldRh5nuwlabSJbdWquSi30YG2aizVHtB0YjTo5zOHI9QisKpqMIgslKH+AMHQx7UPC0y1u8oEpGfA+858tMLdIc29F+u3b/I5Y2nMyClOvG3f23uekTkHX4Fe/qL8= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1717235971; c=relaxed/simple; bh=7WeUby6hGcmXXwKhR1N3FbzbQBU+GzbQDT7UBLqAo6c=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=vywqyK+El0zkmToSoW/PZYJ+SSKWDTur/HpMM+du7D30SYy+p+iOevhQoNO4m/3KtiilBf47qtkM2VAeB8YrKJ/fYNgPi2vAQD0sKBgbzEONrBnDX1fVzjs3u3FYQ62faW7ob4h/GFEloj5WvJmIP3UZQdcJEZR6AytFnh+/ubA= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1717235969; 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=2hkqeDyHRta+o0hiQb24GGXe0DEGTv97lUqVbuaDK1U=; b=LnOVgVSee33zBM1q30W32v7khErfPsVAzDM/BMv6PaV1SnE0TJ1UtPe9Sagi4JTYfzAQvh D/4RhTlp6v/SDu0HoF02X4MffCgSYswv5DZbU7YtwQjr25kefr5fg6ztdogsFIFvd3GpSG fpgkHHVpiqDd0XzjPrUOpsd8/jbJEF4= Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-576-SAftzABuN2yhiyxa12bu7Q-1; Sat, 01 Jun 2024 05:59:24 -0400 X-MC-Unique: SAftzABuN2yhiyxa12bu7Q-1 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) (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 EC5EA8008A4; Sat, 1 Jun 2024 09:59:23 +0000 (UTC) Received: from localhost (unknown [10.42.28.51]) by smtp.corp.redhat.com (Postfix) with ESMTP id A124D3C27; Sat, 1 Jun 2024 09:59:23 +0000 (UTC) From: Jonathan Wakely To: libstdc++@gcc.gnu.org, gcc-patches@gcc.gnu.org Subject: [committed] libstdc++: Replace link to gcc-4.3.2 docs in manual [PR115269] Date: Sat, 1 Jun 2024 10:58:36 +0100 Message-ID: <20240601095923.845009-1-jwakely@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.4.1 on 10.11.54.1 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_SHORT, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H4, RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_NONE, TXREP, T_SCC_BODY_TEXT_LINE 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.30 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces+incoming=patchwork.ozlabs.org@gcc.gnu.org Pushed to trunk. I'll backport this, and link to the appropriate release branch docs instead of the trunk docs. -- >8 -- Link to the docs for GCC trunk instead. For the release branches, the link should be to the docs for appropriate release branch. Also replace the incomplete/outdated list of explicit -std options with a single entry for the -std option. libstdc++-v3/ChangeLog: PR libstdc++/115269 * doc/xml/manual/using.xml: Replace link to gcc-4.3.2 docs. Replace list of -std=... options with a single entry for -std. * doc/html/manual/using.html: Regenerate. --- libstdc++-v3/doc/html/manual/using.html | 10 +++++--- libstdc++-v3/doc/xml/manual/using.xml | 33 ++++--------------------- 2 files changed, 11 insertions(+), 32 deletions(-) diff --git a/libstdc++-v3/doc/html/manual/using.html b/libstdc++-v3/doc/html/manual/using.html index d663660b3a4..fcd1b96de0d 100644 --- a/libstdc++-v3/doc/html/manual/using.html +++ b/libstdc++-v3/doc/html/manual/using.html @@ -4,7 +4,7 @@  Next

Chapter 3. Using

Table of Contents

Command Options
Headers
Header Files
Mixing Headers
The C Headers and namespace std
Precompiled Headers
Macros
Dual ABI
Troubleshooting
Namespaces
Available Namespaces
namespace std
Using Namespace Composition
Linking
Almost Nothing
Finding Dynamic or Shared Libraries
Experimental Library Extensions
Concurrency
Prerequisites
Thread Safety
Atomics
IO
Structure
Defaults
Future
Alternatives
Containers
Exceptions
Exception Safety
Exception Neutrality
Memory allocation
Doing without
Compatibility
With C
With POSIX thread cancellation
Debugging Support
Using g++
Debug Mode
Tracking uncaught exceptions
Memory Leak Hunting
Non-memory leaks in Pool and MT allocators
Data Race Hunting
Using gdb
Debug Versions of Library Binary Files
Compile Time Checking

Command Options

The set of features available in the GNU C++ library is shaped by - several GCC + several GCC Command Options. Options that impact libstdc++ are enumerated and detailed in the table below.

@@ -14,9 +14,11 @@ g++ -std=gnu++17 since GCC 11, and g++ -std=gnu++14 in GCC 6, 7, 8, 9, and 10, and g++ -std=gnu++98 for older releases. -

Table 3.1. C++ Command Options

Option FlagsDescription
-std=c++98 or -std=c++03 - Use the 1998 ISO C++ standard plus amendments.
-std=gnu++98 or -std=gnu++03 - As directly above, with GNU extensions.
-std=c++11Use the 2011 ISO C++ standard.
-std=gnu++11As directly above, with GNU extensions.
-std=c++14Use the 2014 ISO C++ standard.
-std=gnu++14As directly above, with GNU extensions.
+

Table 3.1. C++ Command Options

- -std=c++98 or -std=c++03 + -std - Use the 1998 ISO C++ standard plus amendments. - - - - -std=gnu++98 or -std=gnu++03 + + Select the C++ standard, and whether to use the base standard + or GNU dialect. - As directly above, with GNU extensions. - - - - -std=c++11 - Use the 2011 ISO C++ standard. - - - - -std=gnu++11 - As directly above, with GNU extensions. - - - - -std=c++14 - Use the 2014 ISO C++ standard. - - - - -std=gnu++14 - As directly above, with GNU extensions.
Option FlagsDescription
-std + + Select the C++ standard, and whether to use the base standard + or GNU dialect. +
-fno-exceptions See exception-free dialect
-fno-rtti diff --git a/libstdc++-v3/doc/xml/manual/using.xml b/libstdc++-v3/doc/xml/manual/using.xml index 8ac7e74034c..74321733e8f 100644 --- a/libstdc++-v3/doc/xml/manual/using.xml +++ b/libstdc++-v3/doc/xml/manual/using.xml @@ -7,7 +7,7 @@ The set of features available in the GNU C++ library is shaped by - several GCC + several GCC Command Options. Options that impact libstdc++ are enumerated and detailed in the table below. @@ -37,35 +37,12 @@