From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path:
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 C54153858298
for ; Fri, 16 Feb 2024 10:48:46 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org C54153858298
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 C54153858298
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=1708080528; cv=none;
b=E914rmaOYMgw50WfK+np+b4RN8VuomQoxfEm9axUPOalbaKMvU/MMedLuA2jB52I4LTYuTMpEOBy7X+0ThUtFHjhe/tV2fn3T0PK8/c+EjkDKjwwKdUDtrAn1jmKiKbdXY4Ta2HO7RZRPH2VyLAYAMhfbNSS3SVVRk2Be4VUy+w=
ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key;
t=1708080528; c=relaxed/simple;
bh=qhPCTCDxYO7LPCSTWVXblAbO3lMgt8gcKM0vD9oWASw=;
h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=VTiieixhwqHZauHM1ebF8GzwFragseG6RXfevxjKgZbrhPWjx7gA9VA6hCJrKLSrOdgAXW3Ry+xEhLF26JLrYl0xbQEizML9ffTKV38MaOTEkxw2+FW9oVe6dbkvDzpPMV2M8LZuLUQGyIK3IZoo/rERIfaJqN8d2scz9S8Js98=
ARC-Authentication-Results: i=1; server2.sourceware.org
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;
s=mimecast20190719; t=1708080526;
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=1wHe84bwsJvg9obIq88pjA3kzF/5PSUpViF9sV8b94A=;
b=GhVS/wora+vZQKm1sdkw87zC5PP7HIiB3ojhmMm4qJBVB63Z8TeNFuC7u/3o6fT1ZczG23
7urkAdq6BqrFbXBDJbBrxnNM4PUUtuu/hJtmA7CJH3JkEB1VK44IifX+osWWX3GKeKJK/i
bUJ+3EkvFaUDm+exgeoHLg3ArC2CY9w=
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-512-2zE24vjEOrq4oOaDs68grg-1; Fri,
16 Feb 2024 05:48:44 -0500
X-MC-Unique: 2zE24vjEOrq4oOaDs68grg-1
Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5])
(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 7A3D33C000BC;
Fri, 16 Feb 2024 10:48:44 +0000 (UTC)
Received: from localhost (unknown [10.42.28.206])
by smtp.corp.redhat.com (Postfix) with ESMTP id 480D68CED;
Fri, 16 Feb 2024 10:48:44 +0000 (UTC)
From: Jonathan Wakely
To: libstdc++@gcc.gnu.org,
gcc-patches@gcc.gnu.org
Subject: [committed] libstdc++: Improve docs for debug mode backtraces
Date: Fri, 16 Feb 2024 10:48:38 +0000
Message-ID: <20240216104843.147957-1-jwakely@redhat.com>
MIME-Version: 1.0
X-Scanned-By: MIMEDefang 3.4.1 on 10.11.54.5
X-Mimecast-Spam-Score: 0
X-Mimecast-Originator: redhat.com
Content-Type: text/plain
Content-Transfer-Encoding: 8bit
X-Spam-Status: No, score=-13.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_H4,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
List-Id:
Pushed to trunk.
-- >8 --
The configure option is no longer necessary.
libstdc++-v3/ChangeLog:
* doc/xml/manual/debug_mode.xml: Update docs for backtraces.
* doc/html/manual/debug_mode_using.html: Regenerate.
---
libstdc++-v3/doc/html/manual/debug_mode_using.html | 9 ++++-----
libstdc++-v3/doc/xml/manual/debug_mode.xml | 9 ++++-----
2 files changed, 8 insertions(+), 10 deletions(-)
diff --git a/libstdc++-v3/doc/html/manual/debug_mode_using.html b/libstdc++-v3/doc/html/manual/debug_mode_using.html
index e26d06c9179..70d6692f514 100644
--- a/libstdc++-v3/doc/html/manual/debug_mode_using.html
+++ b/libstdc++-v3/doc/html/manual/debug_mode_using.html
@@ -10,11 +10,10 @@
78 characters. The environment variable
GLIBCXX_DEBUG_MESSAGE_LENGTH can be used to request a
different length.
Note that libstdc++ is able to produce backtraces on error.
- It requires that you configure libstdc++ build with
- --enable-libstdcxx-backtrace=yes.
- Use -D_GLIBCXX_DEBUG_BACKTRACE to activate it.
- You'll then have to link with libstdc++_libbacktrace static library
- (-lstdc++_libbacktrace) to build your application.
Using a Specific Debug Container
When it is not feasible to recompile your entire application, or
+ To enable these, compile with -D_GLIBCXX_DEBUG_BACKTRACE
+ and then link with -lstdc++exp.
+ These backtraces are not supported on all platforms.
+
Using a Specific Debug Container
When it is not feasible to recompile your entire application, or
only specific containers need checking, debugging containers are
available as GNU extensions. These debugging containers are
functionally equivalent to the standard drop-in containers used in
diff --git a/libstdc++-v3/doc/xml/manual/debug_mode.xml b/libstdc++-v3/doc/xml/manual/debug_mode.xml
index ac15ef6f6d0..a12158fa03e 100644
--- a/libstdc++-v3/doc/xml/manual/debug_mode.xml
+++ b/libstdc++-v3/doc/xml/manual/debug_mode.xml
@@ -162,11 +162,10 @@ which always works correctly.
different length.
Note that libstdc++ is able to produce backtraces on error.
- It requires that you configure libstdc++ build with
- .
- Use -D_GLIBCXX_DEBUG_BACKTRACE to activate it.
- You'll then have to link against libstdc++exp static library
- () to build your application.
+ To enable these, compile with -D_GLIBCXX_DEBUG_BACKTRACE
+ and then link with .
+ These backtraces are not supported on all platforms.
+
Using a Specific Debug Container
--
2.43.0