From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 15391 invoked by alias); 6 Mar 2013 21:17:40 -0000 Received: (qmail 15381 invoked by uid 22791); 6 Mar 2013 21:17:40 -0000 X-SWARE-Spam-Status: No, hits=-6.7 required=5.0 tests=AWL,BAYES_00,KHOP_RCVD_UNTRUST,KHOP_SPAMHAUS_DROP,RCVD_IN_DNSWL_HI,RCVD_IN_HOSTKARMA_W,RP_MATCHES_RCVD,SPF_HELO_PASS X-Spam-Check-By: sourceware.org Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Wed, 06 Mar 2013 21:17:33 +0000 Received: from int-mx02.intmail.prod.int.phx2.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.12]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id r26LHXtZ031341 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Wed, 6 Mar 2013 16:17:33 -0500 Received: from barimba (ovpn01.gateway.prod.ext.phx2.redhat.com [10.5.9.1]) by int-mx02.intmail.prod.int.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id r26LHWbv020469 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO); Wed, 6 Mar 2013 16:17:32 -0500 From: Tom Tromey To: gdb-patches@sourceware.org Subject: [1/10] RFC: clean up some catchpoint documentation Date: Wed, 06 Mar 2013 21:17:00 -0000 Message-ID: <8738w8kz2r.fsf@fleche.redhat.com> MIME-Version: 1.0 Content-Type: text/plain Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2013-03/txt/msg00233.txt.bz2 This patch removes some obsolete text from the catchpoint node. This text is for the old C++ ABI (before November 2000) and is further obsoleted by "catch throw". Tom * gdb.texinfo (Set Catchpoints): Remove obsolete text. --- gdb/doc/gdb.texinfo | 30 ------------------------------ 1 files changed, 0 insertions(+), 30 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 5f39d2e..181e5cc 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -4289,36 +4289,6 @@ You cannot raise an exception interactively. You cannot install an exception handler interactively. @end itemize -@cindex raise exceptions -Sometimes @code{catch} is not the best way to debug exception handling: -if you need to know exactly where an exception is raised, it is better to -stop @emph{before} the exception handler is called, since that way you -can see the stack before any unwinding takes place. If you set a -breakpoint in an exception handler instead, it may not be easy to find -out where the exception was raised. - -To stop just before an exception handler is called, you need some -knowledge of the implementation. In the case of @sc{gnu} C@t{++}, exceptions are -raised by calling a library function named @code{__raise_exception} -which has the following ANSI C interface: - -@smallexample - /* @var{addr} is where the exception identifier is stored. - @var{id} is the exception identifier. */ - void __raise_exception (void **addr, void *id); -@end smallexample - -@noindent -To make the debugger catch all exceptions before any stack -unwinding takes place, set a breakpoint on @code{__raise_exception} -(@pxref{Breakpoints, ,Breakpoints; Watchpoints; and Exceptions}). - -With a conditional breakpoint (@pxref{Conditions, ,Break Conditions}) -that depends on the value of @var{id}, you can stop your program when -a specific exception is raised. You can use multiple conditional -breakpoints to stop your program when any of a number of exceptions are -raised. - @node Delete Breaks @subsection Deleting Breakpoints -- 1.7.7.6