expand a bit the in-GDB help for the "catch exception" help text
authorJoel Brobecker <brobecker@adacore.com>
Sat, 12 Jan 2019 14:47:58 +0000 (09:47 -0500)
committerJoel Brobecker <brobecker@adacore.com>
Sat, 12 Jan 2019 14:47:58 +0000 (09:47 -0500)
One of our users remarked that the help doesn't mention the fact that
the "catch exception" supports the special argument "unhandled" to catch
exceptions which do not have a handler. This patch changes the output
of...

 | (gdb) help catch exception
 | Catch Ada exceptions, when raised.
 | With an argument, catch only exceptions with the given name.

... to ...

 | (gdb) help catch exception
 | Catch Ada exceptions, when raised.
 | Usage: catch exception [ ARG ]
 |
 | Without any argument, stop when any Ada exception is raised.
 | If ARG is "unhandled" (without the quotes), only stop when the exception
 | being raised does not have a handler (and will therefore lead to the task's
 | termination).
 | Otherwise, the catchpoint only stops when the name of the exception being
 | raised is the same as ARG.

gdb/ChangeLog:

        * ada-lang.c (_initialize_ada_language): Expand the help text
        for the "catch exception" command.

Tested on x86_64-linux, no regression.

gdb/ChangeLog
gdb/ada-lang.c

index e0b47b4bb09a0bd612780f53a081505cccb2d071..29b525ae38956e2782709a8227acd87caef7c08d 100644 (file)
@@ -1,3 +1,8 @@
+2019-10-12  Joel Brobecker  <brobecker@adacore.com>
+
+       * ada-lang.c (_initialize_ada_language): Expand the help text
+       for the "catch exception" command.
+
 2019-01-12  Philippe Waroquiers  <philippe.waroquiers@skynet.be>
 
        * symtab.c (matching_obj_sections): Initialize obj,
index f552f13a418313702fc74630277418533d141cab..dbd258a6088bd7459b6db449a3d5a827aa4a8061 100644 (file)
@@ -14508,7 +14508,14 @@ overloads selection menu is activated"),
 
   add_catch_command ("exception", _("\
 Catch Ada exceptions, when raised.\n\
-With an argument, catch only exceptions with the given name."),
+Usage: catch exception [ ARG ]\n\
+\n\
+Without any argument, stop when any Ada exception is raised.\n\
+If ARG is \"unhandled\" (without the quotes), only stop when the exception\n\
+being raised does not have a handler (and will therefore lead to the task's\n\
+termination).\n\
+Otherwise, the catchpoint only stops when the name of the exception being\n\
+raised is the same as ARG."),
                     catch_ada_exception_command,
                      NULL,
                     CATCH_PERMANENT,