[RFA/doco] expand solib_unloaded documentation...

[Joel Brobecker <brobecker@adacore.com>]

[-- Attachment #1: Type: text/plain, Size: 568 bytes --]

Hello,

It turns out from a discussion on when to reset watchpoint expressions
that it's important to know when solib_unloaded notifications are sent
(either before or after the solib's symbols are unloaded). Right now,
the notications are sent before, so this patch documents this fact.

2009-09-23  Joel Brobecker  <brobecker@adacore.com>

        * observer.texi (solib_unloaded): Document explicitly the fact that
        this observer is called before the associated symbols are unloaded.

Tested by rebuilding gdb on x86_64-linux.
OK to apply?

Thanks,
-- 
Joel

[-- Attachment #2: solib_unloaded.diff --]
[-- Type: text/x-diff, Size: 819 bytes --]

commit 3bfb23d8921e95be5745080b913c0a81be6907fe
Author: Joel Brobecker <brobecker@adacore.com>
Date:   Wed Sep 23 15:39:24 2009 -0700

        * observer.texi (solib_unloaded): Document explicitly the fact that
        this observer is called before the associated symbols are unloaded.

diff --git a/gdb/doc/observer.texi b/gdb/doc/observer.texi
index 4984f31..77d6b47 100644
--- a/gdb/doc/observer.texi
+++ b/gdb/doc/observer.texi
@@ -122,6 +122,8 @@ haven't been loaded yet.
 
 @deftypefun void solib_unloaded (struct so_list *@var{solib})
 The shared library specified by @var{solib} has been unloaded.
+Note that when @value{GDBN} calls this observer, the library's
+symbols have not been unloaded yet, and thus are still available.
 @end deftypefun
 
 @deftypefun void new_objfile (struct objfile *@var{objfile})