From patchwork Fri Feb 16 10:48:38 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Wakely X-Patchwork-Id: 85874 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 43A8F38582A9 for ; Fri, 16 Feb 2024 10:50:46 +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 D4BF33858285 for ; Fri, 16 Feb 2024 10:48:46 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org D4BF33858285 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 D4BF33858285 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 X-Spam-Status: No, score=-12.3 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=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+patchwork=sourceware.org@gcc.gnu.org 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