From patchwork Sat Aug 17 13:22:18 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Gerald Pfeifer X-Patchwork-Id: 1973490 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=pfeifer.com header.i=@pfeifer.com header.a=rsa-sha256 header.s=pair-202402271039 header.b=3yIzuVn8; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org (client-ip=8.43.85.97; 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 [8.43.85.97]) (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 4WmKKq2J3Jz1yXb for ; Sat, 17 Aug 2024 23:22:53 +1000 (AEST) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 1F86A386100E for ; Sat, 17 Aug 2024 13:22:51 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from hamza.pair.com (hamza.pair.com [209.68.5.143]) by sourceware.org (Postfix) with ESMTPS id 83745386075E; Sat, 17 Aug 2024 13:22:21 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 83745386075E Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=pfeifer.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=pfeifer.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 83745386075E Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=209.68.5.143 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1723900944; cv=none; b=HWUoV3W3RV5CeL4+lZ8wIbQPrU0CNn5gZLdAaw6oS0A2Pt5scxUXAwa77PPjnTTZz7FK66tEN7QrjZzCwAYMG/pKk6VUkxRkPIEcQdBBtFAs1d9U2P97MXqr2703ewl8Sj9l/i9NztJ5QZZNm7Rm7T4pMo9ePyLRCfpFG722Bp4= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1723900944; c=relaxed/simple; bh=IGDW8NOpyA3NhB1wqdGTtRshEsMsiC8hGTMj6EvYgxU=; h=Date:From:To:Subject:MIME-Version:DKIM-Signature:Message-Id; b=gdyyA08UnuJrUCpW7ZwVngNdzHoY3nC81OLnZBDqNeOrKsIVw52MxeYH0ZTM52PRgtMt07+3KY5zkfH3uPbL6wHR1KVqWIFtPcI6hpYwKV6imallc1X3gcbFW4vFkRKuSOWOvWw+QVldKD4SMKN5bfL1sahhg4/fAPA3bGjQhgM= ARC-Authentication-Results: i=1; server2.sourceware.org Received: from hamza.pair.com (localhost [127.0.0.1]) by hamza.pair.com (Postfix) with ESMTP id EEF7B33E87; Sat, 17 Aug 2024 09:22:20 -0400 (EDT) Received: from daya.localdomain (188-23-62-115.adsl.highway.telekom.at [188.23.62.115]) (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 hamza.pair.com (Postfix) with ESMTPSA id 518BE33E86; Sat, 17 Aug 2024 09:22:20 -0400 (EDT) Date: Sat, 17 Aug 2024 15:22:18 +0200 (CEST) From: Gerald Pfeifer To: gcc-patches@gcc.gnu.org, libstdc++@gcc.gnu.org Subject: [pushed] libstdc++: Update references to gcc.gnu.org/onlinedocs MIME-Version: 1.0 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=pfeifer.com; h=date:from:to:subject:mime-version:content-type; s=pair-202402271039; bh=1FYl0jklKPJuj0YB620k8MAxWyFVsK5y+pSRElbGI9I=; b=3yIzuVn8nsHAJdkk6lYIAgFAtnkqyTO1qG7uOdjcd7eTy2/U/qUotEhQMx7lVMMTsPS01s2rbgPGgUEucpoFRpvfOgnW7enyyYzLq1GIAxgvwiYHk82ZVQ/T55j9gPS8yaFVY/Pnn6wZv8J7MHgiCUNs/BPPZely42I97JAznjmxCRxIUcVl+V9MQJr/K+Op4vLBUuqI8mxVlQdHNyjuzZTsybJHDOkhFw1S1vwHSZxLJhHYRuEGb9X+ggzSv6HJuxFK1csfxI4oACtnscFjCPn15om8OGCCVmV1g8goqaGflrELsIYJcnkOaHtCmxJz/J9QjintIwY9rffNCO2iAw== X-Scanned-By: mailmunge 3.11 on 209.68.5.143 Message-Id: <20240817132220.EEF7B33E87@hamza.pair.com> X-Spam-Status: No, score=-10.1 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, KAM_SHORT, RCVD_IN_BARRACUDACENTRAL, SPF_HELO_NONE, SPF_PASS, 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 libstdc++-v3: * doc/xml/manual/abi.xml: Update reference to gcc.gnu.org/onlinedocs. * doc/xml/manual/concurrency_extensions.xml (interface): Ditto. * doc/xml/manual/extensions.xml: Ditto. * doc/xml/manual/parallel_mode.xml: Ditto. * doc/xml/manual/shared_ptr.xml: Ditto. * doc/xml/manual/using_exceptions.xml: Ditto. And change GNU GCC to GCC. * doc/html/manual/abi.html: Regenerate. * doc/html/manual/ext_concurrency_impl.html: Ditto. * doc/html/manual/ext_demangling.html: Ditto. * doc/html/manual/memory.html: Ditto. * doc/html/manual/parallel_mode_design.html: Ditto. * doc/html/manual/parallel_mode_using.html: Ditto. * doc/html/manual/using_exceptions.html: Ditto. --- libstdc++-v3/doc/html/manual/abi.html | 2 +- libstdc++-v3/doc/html/manual/ext_concurrency_impl.html | 4 ++-- libstdc++-v3/doc/html/manual/ext_demangling.html | 2 +- libstdc++-v3/doc/html/manual/memory.html | 2 +- libstdc++-v3/doc/html/manual/parallel_mode_design.html | 2 +- libstdc++-v3/doc/html/manual/parallel_mode_using.html | 2 +- libstdc++-v3/doc/html/manual/using_exceptions.html | 2 +- libstdc++-v3/doc/xml/manual/abi.xml | 2 +- libstdc++-v3/doc/xml/manual/concurrency_extensions.xml | 4 ++-- libstdc++-v3/doc/xml/manual/extensions.xml | 2 +- libstdc++-v3/doc/xml/manual/parallel_mode.xml | 4 ++-- libstdc++-v3/doc/xml/manual/shared_ptr.xml | 2 +- libstdc++-v3/doc/xml/manual/using_exceptions.xml | 4 ++-- 13 files changed, 17 insertions(+), 17 deletions(-) diff --git a/libstdc++-v3/doc/html/manual/abi.html b/libstdc++-v3/doc/html/manual/abi.html index 0eb6a12a501..8dab47dbb93 100644 --- a/libstdc++-v3/doc/html/manual/abi.html +++ b/libstdc++-v3/doc/html/manual/abi.html @@ -28,7 +28,7 @@ g++ command line options may change the ABI as a side-effect of use. Such flags include -fpack-struct and -fno-exceptions, but include others: see the complete - list in the GCC manual under the heading Options + list in the GCC manual under the heading Options for Code Generation Conventions.

The configure options used when building a specific libstdc++ diff --git a/libstdc++-v3/doc/html/manual/ext_concurrency_impl.html b/libstdc++-v3/doc/html/manual/ext_concurrency_impl.html index 23b90f34572..669c07cf291 100644 --- a/libstdc++-v3/doc/html/manual/ext_concurrency_impl.html +++ b/libstdc++-v3/doc/html/manual/ext_concurrency_impl.html @@ -34,7 +34,7 @@ non-ancient x86 hardware, -march=native usually does t trick.

For hosts without compiler intrinsics, but with capable hardware, hand-crafted assembly is selected. This is the case for the following hosts:

  • cris

  • hppa

  • i386

  • i486

  • m48k

  • mips

  • sparc

And for the rest, a simulated atomic lock via pthreads. -

Detailed information about compiler intrinsics for atomic operations can be found in the GCC documentation. +

Detailed information about compiler intrinsics for atomic operations can be found in the GCC documentation.

More details on the library fallbacks from the porting section.

Thread Abstraction

A thin layer above IEEE 1003.1 (i.e. pthreads) is used to abstract the thread interface for GCC. This layer is called "gthread," and is @@ -44,7 +44,7 @@ a POSIX-like interface. the current host. In libstdc++ implementation files, <bits/gthr.h> is used to select the proper gthreads file.

Within libstdc++ sources, all calls to underlying thread functionality -use this layer. More detail as to the specific interface can be found in the source documentation. +use this layer. More detail as to the specific interface can be found in the source documentation.

By design, the gthread layer is interoperable with the types, functions, and usage found in the usual <pthread.h> file, including pthread_t, pthread_once_t, pthread_create, diff --git a/libstdc++-v3/doc/html/manual/ext_demangling.html b/libstdc++-v3/doc/html/manual/ext_demangling.html index b5fb87b91c5..1eae99a1859 100644 --- a/libstdc++-v3/doc/html/manual/ext_demangling.html +++ b/libstdc++-v3/doc/html/manual/ext_demangling.html @@ -7,7 +7,7 @@ original C++ source identifiers is called ???demangling.???

- If you have read the source + If you have read the source documentation for namespace abi then you are aware of the cross-vendor C++ ABI in use by GCC. One of the exposed functions is used for demangling, diff --git a/libstdc++-v3/doc/html/manual/memory.html b/libstdc++-v3/doc/html/manual/memory.html index 6b707105969..8b583591d7d 100644 --- a/libstdc++-v3/doc/html/manual/memory.html +++ b/libstdc++-v3/doc/html/manual/memory.html @@ -525,7 +525,7 @@ available policies are: _S_atomic

Selected when GCC supports a builtin atomic compare-and-swap operation -on the target processor (see Atomic +on the target processor (see Atomic Builtins.) The reference counts are maintained using a lock-free algorithm and GCC's atomic builtins, which provide the required memory synchronisation. diff --git a/libstdc++-v3/doc/html/manual/parallel_mode_design.html b/libstdc++-v3/doc/html/manual/parallel_mode_design.html index 1d5cbbc99d9..c2090940d24 100644 --- a/libstdc++-v3/doc/html/manual/parallel_mode_design.html +++ b/libstdc++-v3/doc/html/manual/parallel_mode_design.html @@ -174,7 +174,7 @@ i. e. it is a singleton. It can be read and written by calling __gnu_parallel::_Settings::set, respectively. Please note that the first call return a const object, so direct manipulation is forbidden. -See +See <parallel/settings.h> for complete details.

diff --git a/libstdc++-v3/doc/html/manual/parallel_mode_using.html b/libstdc++-v3/doc/html/manual/parallel_mode_using.html index 1f151f4ed7b..38d629fe74f 100644 --- a/libstdc++-v3/doc/html/manual/parallel_mode_using.html +++ b/libstdc++-v3/doc/html/manual/parallel_mode_using.html @@ -5,7 +5,7 @@ not difficult: just compile your application with the compiler flag -fopenmp. This will link in libgomp, the - GNU Offloading and + GNU Offloading and Multi Processing Runtime Library, whose presence is mandatory.

diff --git a/libstdc++-v3/doc/html/manual/using_exceptions.html b/libstdc++-v3/doc/html/manual/using_exceptions.html index e5ef8be3a42..f3556ef9d75 100644 --- a/libstdc++-v3/doc/html/manual/using_exceptions.html +++ b/libstdc++-v3/doc/html/manual/using_exceptions.html @@ -167,7 +167,7 @@ exception neutrality and exception safety. support try and catch blocks and thrown objects. (Language support for -fno-exceptions is documented in the GNU - GCC manual.) + GCC manual.)

Before detailing the library support for -fno-exceptions, first a passing note on the things lost when this flag is used: it will break exceptions diff --git a/libstdc++-v3/doc/xml/manual/abi.xml b/libstdc++-v3/doc/xml/manual/abi.xml index a4ce866b884..15954ae880d 100644 --- a/libstdc++-v3/doc/xml/manual/abi.xml +++ b/libstdc++-v3/doc/xml/manual/abi.xml @@ -52,7 +52,7 @@ g++ command line options may change the ABI as a side-effect of use. Such flags include -fpack-struct and -fno-exceptions, but include others: see the complete - list in the GCC manual under the heading Options + list in the GCC manual under the heading Options for Code Generation Conventions. diff --git a/libstdc++-v3/doc/xml/manual/concurrency_extensions.xml b/libstdc++-v3/doc/xml/manual/concurrency_extensions.xml index 6499fda58c3..e845431818b 100644 --- a/libstdc++-v3/doc/xml/manual/concurrency_extensions.xml +++ b/libstdc++-v3/doc/xml/manual/concurrency_extensions.xml @@ -267,7 +267,7 @@ hardware, hand-crafted assembly is selected. This is the case for the following And for the rest, a simulated atomic lock via pthreads. - Detailed information about compiler intrinsics for atomic operations can be found in the GCC documentation. +Detailed information about compiler intrinsics for atomic operations can be found in the GCC documentation. More details on the library fallbacks from the porting section. @@ -290,7 +290,7 @@ the current host. In libstdc++ implementation files, Within libstdc++ sources, all calls to underlying thread functionality -use this layer. More detail as to the specific interface can be found in the source documentation. +use this layer. More detail as to the specific interface can be found in the source documentation. By design, the gthread layer is interoperable with the types, diff --git a/libstdc++-v3/doc/xml/manual/extensions.xml b/libstdc++-v3/doc/xml/manual/extensions.xml index 490a50cc331..d0460b0d90c 100644 --- a/libstdc++-v3/doc/xml/manual/extensions.xml +++ b/libstdc++-v3/doc/xml/manual/extensions.xml @@ -504,7 +504,7 @@ get_temporary_buffer(5, (int*)0); demangling. - If you have read the source + If you have read the source documentation for namespace abi then you are aware of the cross-vendor C++ ABI in use by GCC. One of the exposed functions is used for demangling, diff --git a/libstdc++-v3/doc/xml/manual/parallel_mode.xml b/libstdc++-v3/doc/xml/manual/parallel_mode.xml index cabb9d76a4c..22f432f762c 100644 --- a/libstdc++-v3/doc/xml/manual/parallel_mode.xml +++ b/libstdc++-v3/doc/xml/manual/parallel_mode.xml @@ -121,7 +121,7 @@ It might work with other compilers, though. flag -fopenmp. This will link in libgomp, the GNU Offloading and + xlink:href="https://gcc.gnu.org/onlinedocs/libgomp/">GNU Offloading and Multi Processing Runtime Library, whose presence is mandatory. @@ -739,7 +739,7 @@ i. e. it is a singleton. It can be read and written by calling __gnu_parallel::_Settings::set, respectively. Please note that the first call return a const object, so direct manipulation is forbidden. -See +See <parallel/settings.h> for complete details. diff --git a/libstdc++-v3/doc/xml/manual/shared_ptr.xml b/libstdc++-v3/doc/xml/manual/shared_ptr.xml index 07cc4d52715..3d59a04c504 100644 --- a/libstdc++-v3/doc/xml/manual/shared_ptr.xml +++ b/libstdc++-v3/doc/xml/manual/shared_ptr.xml @@ -243,7 +243,7 @@ available policies are: Selected when GCC supports a builtin atomic compare-and-swap operation -on the target processor (see Atomic +on the target processor (see Atomic Builtins.) The reference counts are maintained using a lock-free algorithm and GCC's atomic builtins, which provide the required memory synchronisation. diff --git a/libstdc++-v3/doc/xml/manual/using_exceptions.xml b/libstdc++-v3/doc/xml/manual/using_exceptions.xml index b7a0cc08497..ab42c809939 100644 --- a/libstdc++-v3/doc/xml/manual/using_exceptions.xml +++ b/libstdc++-v3/doc/xml/manual/using_exceptions.xml @@ -282,8 +282,8 @@ exception neutrality and exception safety. implicitly generated magic necessary to support try and catch blocks and thrown objects. (Language support - for -fno-exceptions is documented in the GNU - GCC manual.) + for -fno-exceptions is documented in the GCC + manual.) Before detailing the library support