FreeChainXenon/binutils-gdb
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

add @kindex for catchpoints

Browse source 
I wanted to find the docs for "catch load" the other day, and I found
out that this isn't in the index.  It seems to me that each command
ought to be in the index for quick reference like this, so this patch
adds an @kindex (chosen because it seems to be what the rest of the
manual does) for each "catch" subcommand.

2013-12-03  Tom Tromey  <tromey@redhat.com>

	* gdb.texinfo (Set Catchpoints): Add @kindex for each command
	documented here.
This commit is contained in:
Tom Tromey 2013-12-03 13:04:16 -07:00
parent 6cb999f8df
commit 1a4f73eb8a
2 changed files with 19 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

5
gdb/doc/ChangeLog
View file

@ -1,3 +1,8 @@
2013-12-03 Tom Tromey <tromey@redhat.com>
* gdb.texinfo (Set Catchpoints): Add @kindex for each command
documented here.
2013-12-03 Tom Tromey <tromey@redhat.com> 2013-12-03 Tom Tromey <tromey@redhat.com>
* gdb.texinfo (@direntry): Add menu item for gdbserver. * gdb.texinfo (@direntry): Add menu item for gdbserver.

14
gdb/doc/gdb.texinfo
View file

@ -4108,6 +4108,9 @@ Stop when @var{event} occurs. @var{event} can be any of the following:
@item throw @r{[}@var{regexp}@r{]} @item throw @r{[}@var{regexp}@r{]}
@itemx rethrow @r{[}@var{regexp}@r{]} @itemx rethrow @r{[}@var{regexp}@r{]}
@itemx catch @r{[}@var{regexp}@r{]} @itemx catch @r{[}@var{regexp}@r{]}
@kindex catch throw
@kindex catch rethrow
@kindex catch catch
@cindex stop on C@t{++} exceptions @cindex stop on C@t{++} exceptions
The throwing, re-throwing, or catching of a C@t{++} exception. The throwing, re-throwing, or catching of a C@t{++} exception.
@ -4165,6 +4168,7 @@ You cannot install an exception handler interactively.
@end itemize @end itemize
@item exception @item exception
@kindex catch exception
@cindex Ada exception catching @cindex Ada exception catching
@cindex catch Ada exceptions @cindex catch Ada exceptions
An Ada exception being raised. If an exception name is specified An Ada exception being raised. If an exception name is specified
@ -4182,18 +4186,22 @@ the command to use to catch such exceptions is @kbd{catch exception
Pck.Constraint_Error}. Pck.Constraint_Error}.
@item exception unhandled @item exception unhandled
@kindex catch exception unhandled
An exception that was raised but is not handled by the program. An exception that was raised but is not handled by the program.
@item assert @item assert
@kindex catch assert
A failed Ada assertion. A failed Ada assertion.
@item exec @item exec
@kindex catch exec
@cindex break on fork/exec @cindex break on fork/exec
A call to @code{exec}. This is currently only available for HP-UX A call to @code{exec}. This is currently only available for HP-UX
and @sc{gnu}/Linux. and @sc{gnu}/Linux.
@item syscall @item syscall
@itemx syscall @r{[}@var{name} @r{|} @var{number}@r{]} @dots{} @itemx syscall @r{[}@var{name} @r{|} @var{number}@r{]} @dots{}
@kindex catch syscall
@cindex break on a system call. @cindex break on a system call.
A call to or return from a system call, a.k.a.@: @dfn{syscall}. A A call to or return from a system call, a.k.a.@: @dfn{syscall}. A
syscall is a mechanism for application programs to request a service syscall is a mechanism for application programs to request a service
@ -4324,20 +4332,25 @@ Catchpoint 1 (syscall(s) 252)
Again, in this case @value{GDBN} would not be able to display syscall's names. Again, in this case @value{GDBN} would not be able to display syscall's names.
@item fork @item fork
@kindex catch fork
A call to @code{fork}. This is currently only available for HP-UX A call to @code{fork}. This is currently only available for HP-UX
and @sc{gnu}/Linux. and @sc{gnu}/Linux.
@item vfork @item vfork
@kindex catch vfork
A call to @code{vfork}. This is currently only available for HP-UX A call to @code{vfork}. This is currently only available for HP-UX
and @sc{gnu}/Linux. and @sc{gnu}/Linux.
@item load @r{[}regexp@r{]} @item load @r{[}regexp@r{]}
@itemx unload @r{[}regexp@r{]} @itemx unload @r{[}regexp@r{]}
@kindex catch load
@kindex catch unload
The loading or unloading of a shared library. If @var{regexp} is The loading or unloading of a shared library. If @var{regexp} is
given, then the catchpoint will stop only if the regular expression given, then the catchpoint will stop only if the regular expression
matches one of the affected libraries. matches one of the affected libraries.
@item signal @r{[}@var{signal}@dots{} @r{|} @samp{all}@r{]} @item signal @r{[}@var{signal}@dots{} @r{|} @samp{all}@r{]}
@kindex catch signal
The delivery of a signal. The delivery of a signal.
With no arguments, this catchpoint will catch any signal that is not With no arguments, this catchpoint will catch any signal that is not
@ -4365,6 +4378,7 @@ commands.
@end table @end table
@item tcatch @var{event} @item tcatch @var{event}
@kindex tcatch
Set a catchpoint that is enabled only for one stop. The catchpoint is Set a catchpoint that is enabled only for one stop. The catchpoint is
automatically deleted after the first time the event is caught. automatically deleted after the first time the event is caught.