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

[Joel Brobecker]

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
-------------- next part --------------
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.