From patchwork Wed Oct 30 21:13:34 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Wakely X-Patchwork-Id: 2004379 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=aXCBXrzn; 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 4Xf0Jx21M2z1xx7 for ; Thu, 31 Oct 2024 08:15:29 +1100 (AEDT) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 7555B3857C7A for ; Wed, 30 Oct 2024 21:15:27 +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 ESMTP id E33E83857829 for ; Wed, 30 Oct 2024 21:13:50 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org E33E83857829 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 E33E83857829 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=1730322833; cv=none; b=DPZ4mT+++45ERN0p4hapdIa5EP+zM7FcxuyRklh3Inz5YYTv6XSj2/3028jRNi0QrKPGLT9cdnoQfifZpFwQMm1+l6hXgoAvK0kg9eoCqtm9G2JsG7ccY611NofJrUkZIXb3A0bJ2TBS6XCOd47LUX60CE0N1Z/dJEtQI3/cGMg= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1730322833; c=relaxed/simple; bh=JHvc30SWfxia06+hEu3cOmf6ZKNUkVJPkexnyZOYPWk=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=fbyYz5RZVkWO7NB4QhuiwivUScz3K/ADEBPnZqGZasRei+6KVvkn/vUIZysj4fQCuo3ObBqlzEOO4gl8cD6fwMJD0ps0Iq3HJVJEQMuXCNgbMGLwztZ5gM+EKRFSJi17eWdEdISHYF+Qxk3YHS082gcuyfx8IJMgmAkOT7WjTuY= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1730322830; 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=JVOrF0cnR3rtLbG4b+1lDmBjbuAE3NFKdYQ8ePkxPck=; b=aXCBXrznU7jUTO2HBmXUxOAvY2CeCZM1hS+452b++LVZCWxqn+HDwgfg3t8Qt+jxqHkpwq zAD09cUo+rWE9YUSUekEKm3gY+cSHxFh+B8l7+5QTaRVMsR84vyMczQckmU3RvFad3QXx3 hTO70rtqs4/lS8MDdjKwIXukdRHIPEQ= Received: from mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-644-jAXBhlNsMMGWi_KBvEgZqw-1; Wed, 30 Oct 2024 17:13:47 -0400 X-MC-Unique: jAXBhlNsMMGWi_KBvEgZqw-1 Received: from mx-prod-int-02.mail-002.prod.us-west-2.aws.redhat.com (mx-prod-int-02.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.15]) (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 mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS id DFF94195608B; Wed, 30 Oct 2024 21:13:45 +0000 (UTC) Received: from localhost (unknown [10.42.28.115]) by mx-prod-int-02.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP id 2970E1956086; Wed, 30 Oct 2024 21:13:44 +0000 (UTC) From: Jonathan Wakely To: libstdc++@gcc.gnu.org, gcc-patches@gcc.gnu.org Subject: [committed] libstdc++: Fix some typos and grammatical errors in docs Date: Wed, 30 Oct 2024 21:13:34 +0000 Message-ID: <20241030211343.1321549-1-jwakely@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.0 on 10.30.177.15 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com 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 Also remove some redundant 'void' parameters from code examples. libstdc++-v3/ChangeLog: * doc/xml/manual/using_exceptions.xml: Fix typos and grammatical errors. * doc/html/manual/using_exceptions.html: Regenerate. --- Pushed to trunk. libstdc++-v3/doc/html/manual/using_exceptions.html | 12 ++++++------ libstdc++-v3/doc/xml/manual/using_exceptions.xml | 12 ++++++------ 2 files changed, 12 insertions(+), 12 deletions(-) diff --git a/libstdc++-v3/doc/html/manual/using_exceptions.html b/libstdc++-v3/doc/html/manual/using_exceptions.html index 706b27e1479..eb4501b1f6b 100644 --- a/libstdc++-v3/doc/html/manual/using_exceptions.html +++ b/libstdc++-v3/doc/html/manual/using_exceptions.html @@ -158,7 +158,7 @@ exception neutrality and exception safety.

Doing without

C++ is a language that strives to be as efficient as is possible in delivering features. As such, considerable care is used by both - language implementer and designers to make sure unused features + language implementer and designers to make sure unused features do not impose hidden or unexpected costs. The GNU system tries to be as flexible and as configurable as possible. So, it should come as no surprise that GNU C++ provides an optional language extension, @@ -166,7 +166,7 @@ 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 GCC + for -fno-exceptions is documented in the GCC manual.)

Before detailing the library support for -fno-exceptions, first a passing note on @@ -179,7 +179,7 @@ exception neutrality and exception safety. uses try or catch, you shouldn't use -fno-exceptions.

- And what it to be gained, tinkering in the back alleys with a + And what is to be gained, tinkering in the back alleys with a language like this? Exception handling overhead can be measured in the size of the executable binary, and varies with the capabilities of the underlying operating system and specific @@ -216,15 +216,15 @@ exception neutrality and exception safety. # define __throw_exception_again #endif

- In addition, for every object derived from + In addition, for most of the classes derived from class exception, there exists a corresponding function with C language linkage. An example: 

 #if __cpp_exceptions
-  void __throw_bad_exception(void)
+  void __throw_bad_exception()
   { throw bad_exception(); }
 #else
-  void __throw_bad_exception(void)
+  void __throw_bad_exception()
   { abort(); }
 #endif

diff --git a/libstdc++-v3/doc/xml/manual/using_exceptions.xml b/libstdc++-v3/doc/xml/manual/using_exceptions.xml index ab42c809939..ac2ba9dffd4 100644 --- a/libstdc++-v3/doc/xml/manual/using_exceptions.xml +++ b/libstdc++-v3/doc/xml/manual/using_exceptions.xml @@ -274,7 +274,7 @@ exception neutrality and exception safety. C++ is a language that strives to be as efficient as is possible in delivering features. As such, considerable care is used by both - language implementer and designers to make sure unused features + language implementer and designers to make sure unused features do not impose hidden or unexpected costs. The GNU system tries to be as flexible and as configurable as possible. So, it should come as no surprise that GNU C++ provides an optional language extension, @@ -282,7 +282,7 @@ 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 GCC + for -fno-exceptions is documented in the GCC manual.) @@ -299,7 +299,7 @@ exception neutrality and exception safety. - And what it to be gained, tinkering in the back alleys with a + And what is to be gained, tinkering in the back alleys with a language like this? Exception handling overhead can be measured in the size of the executable binary, and varies with the capabilities of the underlying operating system and specific @@ -344,17 +344,17 @@ exception neutrality and exception safety. - In addition, for every object derived from + In addition, for most of the classes derived from class exception, there exists a corresponding function with C language linkage. An example: #if __cpp_exceptions - void __throw_bad_exception(void) + void __throw_bad_exception() { throw bad_exception(); } #else - void __throw_bad_exception(void) + void __throw_bad_exception() { abort(); } #endif