From 87f67dbac2c40477b490e0eb1c5fa6f275d60bba Mon Sep 17 00:00:00 2001 From: Joel Brobecker Date: Wed, 1 Oct 2008 16:44:47 +0000 Subject: [PATCH] * 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. --- gdb/doc/ChangeLog | 6 ++++++ gdb/doc/gdb.texinfo | 9 +++++++++ 2 files changed, 15 insertions(+) diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 6d1c713887e..4b757e0c04e 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,9 @@ +2008-10-01 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. + 2008-09-27 Tom Tromey * gdb.texinfo (Macros): Remove text about stringification, diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 9db0ff8a764..dddc88b79e5 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -3614,6 +3614,15 @@ at the end of the command (eg @code{catch exception Program_Error}), 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 @kbd{catch exception +Pck.Constraint_Error}. + @item exception unhandled An exception that was raised but is not handled by the program. -- 2.30.2