[RFA/doco/Ada] Document special case for catchpoints on standard exceptions

[RFA/doco/Ada] Document special case for catchpoints on standard exceptions

[Joel Brobecker]

[-- Attachment #1: Type: text/plain, Size: 660 bytes --]

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  <brobecker@adacore.com>

        * 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

[-- Attachment #2: doc-std-exc.diff --]
[-- Type: text/plain, Size: 1072 bytes --]

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.
 

Re: [RFA/doco/Ada] Document special case for catchpoints on standard exceptions

[Eli Zaretskii]

> Date: Tue, 30 Sep 2008 14:10:46 -0700
> From: Joel Brobecker <brobecker@adacore.com>
> 
> This is the documentation part for the following change:
> http://www.sourceware.org/ml/gdb-patches/2008-09/msg00591.html

Thanks.

> OK to commit?

Yes, with one comment:

> +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}.

The last part of the last sentence should be in @kbd, not @code, as it
is a command typed by the user on the keyboard.

Re: [RFA/doco/Ada] Document special case for catchpoints on standard exceptions

[Joel Brobecker]

> > OK to commit?
> 
> Yes, with one comment:

Correction made, and patch checked in. Thanks for the review!

-- 
Joel