* observer.texi (GDB Observers): Adjust the documentation for the

        normal_stop notification to better describe reality. Fix a couple
        of minor typos.

diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog
index 0d935b633d5e583ab6dab6cfcfd058ad88b96f23..7c350336a6bc152c3f82168f5c8f12b00d340b6e 100644 (file)
--- a/gdb/doc/ChangeLog
+++ b/gdb/doc/ChangeLog
@@ -1,3 +1,9 @@
+2003-04-02  J. Brobecker  <brobecker@gnat.com>
+
+       * observer.texi (GDB Observers): Adjust the documentation for the
+       normal_stop notification to better describe reality. Fix a couple
+       of minor typos.
+
 2003-04-02  Bob Rossi  <bob_rossi@cox.net>
 
        * gdb.texinfo (GDB/MI Program Control): Add 

diff --git a/gdb/doc/observer.texi b/gdb/doc/observer.texi
index a967f3200e8bb28a42ef526f927b407a5c4f5233..de48a192a36fa16496e71c4d2aa0fe7e9a1f246d 100644 (file)
--- a/gdb/doc/observer.texi
+++ b/gdb/doc/observer.texi
@@ -12,7 +12,7 @@ notifications, the observer attaches a callback to the subject.
 One subject can have several observers.
 
 @file{observer.c} implements an internal generic low-level event
-notification mechanism.  This generic event notification mechansim is
+notification mechanism.  This generic event notification mechanism is
 then re-used to implement the exported high-level notification
 management routines for all possible notifications.
 
@@ -27,7 +27,7 @@ as it lacks a mechanism that would deallocate this data when the
 callback is detached.  This is not a problem so far, as this contextual
 data is only used internally to hold a function pointer.  Later on, if
 a certain observer needs to provide support for user-level contextual
-data, then the generic notification mechanism will need need to be
+data, then the generic notification mechanism will need to be
 enhanced to allow the observer to provide a routine to deallocate the
 data when attaching the callback.
 
@@ -39,10 +39,16 @@ or detach routines during a notification.
 @cindex @code{normal_stop} observer
 @cindex notification about inferior execution stop
 
-@value{GDBN} will notify all @code{normal_stop} observers when the
-inferior execution has just stopped, and all the associated internal
-processing (such as breakpoint commands, annotations, etc) is about to
-be performed before the @value{GDBN} prompt is returned to the user.
+@value{GDBN} notifies all @code{normal_stop} observers when the
+inferior execution has just stopped, the associated messages and
+annotations have been printed, and the control is about to be returned
+to the user. 
+
+Note that the @code{normal_stop} notification is not emitted when
+the execution stops due to a breakpoint, and this breakpoint has
+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: