summaryrefslogtreecommitdiff
path: root/gdb/doc
diff options
context:
space:
mode:
authorAndrew Cagney <cagney@redhat.com>2004-04-15 14:29:21 +0000
committerAndrew Cagney <cagney@redhat.com>2004-04-15 14:29:21 +0000
commit0d2823c6678af43bcdf45d8aa00026ff3de1a000 (patch)
tree5896cf4b82b804641e96020cec5f55536ff5d3eb /gdb/doc
parent017d459d2d4b820150363e8a95340f4de78d360c (diff)
downloadgdb-0d2823c6678af43bcdf45d8aa00026ff3de1a000.tar.gz
2004-04-15 Andrew Cagney <cagney@redhat.com>
* observer.c (normal_stop_subject, observer_notify_normal_stop) (observer_normal_stop_notification_stub) (observer_attach_normal_stop, observer_detach_normal_stop): Delete, replaced by #include "observer.inc". * infrun.c (normal_stop): Pass "stop_bpstat" to observer_notify_normal_stop. * Makefile.in (observer_inc): Define. (observer.o): Update dependencies. (observer.h, observer.inc): New rules. * observer.h: Delete file. * observer.sh: New file. Index: doc/ChangeLog 2004-04-08 Andrew Cagney <cagney@redhat.com> * observer.texi (GDB Observers): Rework, provide generic observer definitions and then a list of observable events.
Diffstat (limited to 'gdb/doc')
-rw-r--r--gdb/doc/ChangeLog5
-rw-r--r--gdb/doc/observer.texi23
2 files changed, 19 insertions, 9 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 5f1f332c5d1..6e99d31e3aa 100644
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,8 @@
+2004-04-08 Andrew Cagney <cagney@redhat.com>
+
+ * observer.texi (GDB Observers): Rework, provide generic observer
+ definitions and then a list of observable events.
+
2004-04-04 Andrew Cagney <cagney@redhat.com>
* gdbint.texinfo (Host Definition): Delete reference to
diff --git a/gdb/doc/observer.texi b/gdb/doc/observer.texi
index de48a192a36..ee5ab349f4e 100644
--- a/gdb/doc/observer.texi
+++ b/gdb/doc/observer.texi
@@ -50,21 +50,26 @@ a condition that is not met. If the breakpoint has any associated
commands list, the commands are executed after the notification
is emitted.
-The following interface is available to manage @code{normal_stop}
-observers:
+The following interfaces are available to manage observers:
-@deftypefun extern struct observer *observer_attach_normal_stop (observer_normal_stop_ftype *@var{f})
-Attach the given @code{normal_stop} callback function @var{f} and
-return the associated observer.
+@deftypefun extern struct observer *observer_attach_@var{event} (observer_@var{event}_ftype *@var{f})
+Using the function @var{f}, create an observer that is notified when
+ever @var{event} occures, return the observer.
@end deftypefun
-@deftypefun extern void observer_detach_normal_stop (struct observer *@var{observer});
+@deftypefun extern void observer_detach_@var{event} (struct observer *@var{observer});
Remove @var{observer} from the list of observers to be notified when
-a @code{normal_stop} event occurs.
+@var{event} occurs.
@end deftypefun
-@deftypefun extern void observer_notify_normal_stop (void);
-Send a notification to all @code{normal_stop} observers.
+@deftypefun extern void observer_notify_@var{event} (void);
+Send a notification to all @var{event} observers.
@end deftypefun
+The following observable events are defined:
+@c note: all events must take at least one parameter.
+
+@deftypefun void normal_stop (struct bpstats *@var{bs})
+The inferior has stopped for real.
+@end deftypefun