From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 3845 invoked by alias); 30 Sep 2008 21:11:40 -0000 Received: (qmail 3837 invoked by uid 22791); 30 Sep 2008 21:11:39 -0000 X-Spam-Check-By: sourceware.org Received: from rock.gnat.com (HELO rock.gnat.com) (205.232.38.15) by sourceware.org (qpsmtpd/0.31) with ESMTP; Tue, 30 Sep 2008 21:10:50 +0000 Received: from localhost (localhost.localdomain [127.0.0.1]) by filtered-rock.gnat.com (Postfix) with ESMTP id 9520E2A967E for ; Tue, 30 Sep 2008 17:10:48 -0400 (EDT) Received: from rock.gnat.com ([127.0.0.1]) by localhost (rock.gnat.com [127.0.0.1]) (amavisd-new, port 10024) with LMTP id xg1ZrQRzgKir for ; Tue, 30 Sep 2008 17:10:48 -0400 (EDT) Received: from joel.gnat.com (localhost.localdomain [127.0.0.1]) by rock.gnat.com (Postfix) with ESMTP id 5F92F2A9679 for ; Tue, 30 Sep 2008 17:10:48 -0400 (EDT) Received: by joel.gnat.com (Postfix, from userid 1000) id 5A4E2E7ACD; Tue, 30 Sep 2008 14:10:46 -0700 (PDT) Date: Tue, 30 Sep 2008 21:11:00 -0000 From: Joel Brobecker To: gdb-patches@sourceware.org Subject: [RFA/doco/Ada] Document special case for catchpoints on standard exceptions Message-ID: <20080930211046.GB3566@adacore.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="7ZAtKRhVyVSsbBD2" Content-Disposition: inline User-Agent: Mutt/1.4.2.2i 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: 2008-09/txt/msg00592.txt.bz2 --7ZAtKRhVyVSsbBD2 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-length: 660 Hello, This is the documentation part for the following change: http://www.sourceware.org/ml/gdb-patches/2008-09/msg00591.html The case where someone define his own exception re-using an exception name that's already used in the language should be very rare, so I don't really expect many people to be interested in that extra paragraph, but since it's something GDB does... 2008-09-30 Joel Brobecker * gdb.texinfo (catch) [exception]: Document how to insert a breakpoint on user-defined exceptions when the exception name is identical to one of the language-defined ones. OK to commit? Thanks, -- Joel --7ZAtKRhVyVSsbBD2 Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="doc-std-exc.diff" Content-length: 1072 Index: gdb.texinfo =================================================================== RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.525 diff -u -r1.525 gdb.texinfo --- gdb.texinfo 27 Sep 2008 21:40:48 -0000 1.525 +++ gdb.texinfo 30 Sep 2008 21:06:58 -0000 @@ -3614,6 +3614,15 @@ the debugger will stop only when this specific exception is raised. Otherwise, the debugger stops execution when any Ada exception is raised. +When inserting an exception catchpoint on a user-defined exception whose +name is identical to one of the exceptions defined by the language, the +fully qualified name must be used as the exception name. Otherwise, +@value{GDBN} will assume that it should stop on the pre-defined exception +rather than the user-defined one. For instance, assuming an exception +called @code{Constraint_Error} is defined in package @code{Pck}, then +the command to use to catch such exceptions is @code{catch exception +Pck.Constraint_Error}. + @item exception unhandled An exception that was raised but is not handled by the program. --7ZAtKRhVyVSsbBD2--