Re: [RFA/doco] Add documentation for observer.[hc] (gdbint.texinfo)

[Daniel Jacobowitz <drow at mvista dot com>]

On Sat, Mar 08, 2003 at 10:51:55PM -0800, Joel Brobecker wrote:
> The following patch adds some light documentation about the new observer
> paradigm introduced recently.

Thanks.  Two things:


> ***************
> *** 95,100 ****
> --- 95,101 ----
>   * Hints::
>   
>   * GNU Free Documentation License::  The license for this documentation
> + * GDB Observers::  @value{GDBN} Observers currently available
>   * Index::
>   @end menu
>   

Between the GFDL and the Index is probably not a good place for the new
chapter.

> @section @code{normal_stop} Notifications
> 
> @value{GDBN} will notify all @code{normal_stop} observers when the
> inferior execution has just stopped and the @value{GDBN} prompt is
> about to be returned to the user.

Could you be a little more specific?  A lot of things can happen
between the application stopping and control returning to the user. 
For instance:
  - is it before or after breakpoint commands are run, if we hit a
breakpoint?
  - If we're single-stepping multiple times, does normal_stop get
called for each one or only for the last?

My guess is that it's closer to the prompt than to the inferior
stopping, but I haven't checked.

-- 
Daniel Jacobowitz
MontaVista Software                         Debian GNU/Linux Developer