binutils-gdb/gdb/doc
Joel Brobecker e547c119d0 (Ada) provide the exception message when hitting an exception catchpoint
This patch enhances the debugger to print the exception message, when
available, as part of an exception catchpoint hit notification (both
GDB/CLI and GDB/MI). For instance, with the following code...

    procedure A is
    begin
       raise Constraint_Error with "hello world";
    end A;

... instead of printing...

    Catchpoint 1, CONSTRAINT_ERROR at 0x000000000040245c in a () at a.adb:3

... it now prints:

    Catchpoint 1, CONSTRAINT_ERROR (hello world) at 0x000000000040245c in a ()
                                   ^^^^^^^^^^^^^

This enhancement requires runtime support. If not present, the debugger
just behaves as before.

In GDB/MI mode, if the exception message is available, it is provided
as an extra field named "exception-message" in the catchpoint notification:

    *stopped,bkptno="1",[...],exception-name="CONSTRAINT_ERROR",
       exception-message="hello world",[...]

gdb/ChangeLog:

        * ada-lang.c (ada_exception_message_1, ada_exception_message):
        New functions.
        (print_it_exception): If available, display the exception
        message as well.
        * NEWS: Document new feature.

gdb/doc/ChangeLog:

        * gdb.texinfo (GDB/MI Ada Exception Information): Document
        new "exception-message" field.

gdb/testsuite/ChangeLog:

        * gdb.ada/catch_ex.exp, gdb.ada/mi_catch_ex.exp,
        gdb.ada/mi_ex_cond.exp: Accept optional exception message in
        when hitting an exception catchpoint.
2017-11-24 17:15:30 -05:00
..
.gitignore
a4rc.sed
agentexpr.texi Fix documentation about rot agent expression bytecode 2017-07-31 11:26:50 +02:00
all-cfg.texi update copyright year range in GDB files 2017-01-01 10:52:34 +04:00
annotate.texinfo update copyright year range in GDB files 2017-01-01 10:52:34 +04:00
ChangeLog (Ada) provide the exception message when hitting an exception catchpoint 2017-11-24 17:15:30 -05:00
doxy-index.in update copyright year range in GDB files 2017-01-01 10:52:34 +04:00
Doxyfile-base.in update copyright year range in GDB files 2017-01-01 10:52:34 +04:00
Doxyfile-gdb-api.in update copyright year range in GDB files 2017-01-01 10:52:34 +04:00
Doxyfile-gdb-xref.in update copyright year range in GDB files 2017-01-01 10:52:34 +04:00
Doxyfile-gdbserver.in update copyright year range in GDB files 2017-01-01 10:52:34 +04:00
fdl.texi
filter-for-doxygen
filter-params.pl
gdb.texinfo (Ada) provide the exception message when hitting an exception catchpoint 2017-11-24 17:15:30 -05:00
gpl.texi
guile.texi Fix PR gdb/21606: SYMBOL_FUNCTIONS_DOMAIN misspelled in documentation 2017-06-20 21:31:59 -04:00
lpsrc.sed
Makefile.in Introduce "gdb/configure.nat" (and delete "gdb/config/*/*.mh" files) 2017-05-06 10:09:35 -04:00
observer.texi update copyright year range in GDB files 2017-01-01 10:52:34 +04:00
psrc.sed
python.texi Add Python rbreak command. 2017-11-16 14:14:03 +00:00
refcard.tex update copyright year range in GDB files 2017-01-01 10:52:34 +04:00
stabs.texinfo update copyright year range in GDB files 2017-01-01 10:52:34 +04:00
stack_frame.eps
stack_frame.pdf
stack_frame.png
stack_frame.svg
stack_frame.txt