symtab.h (lookup_global_symbol): Improve function comment.

gdb/ChangeLog:

	* symtab.h (lookup_global_symbol): Improve function comment.

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 42ecfc4..f75a5ba 100644 (file)
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,5 +1,9 @@
 2014-11-06  Doug Evans  <xdje42@gmail.com>
 
+       * symtab.h (lookup_global_symbol): Improve function comment.
+
+2014-11-06  Doug Evans  <xdje42@gmail.com>
+
        * symtab.c (lookup_global_symbol): Renamed from lookup_symbol_global.
        All callers updated.
        * symtab.h (lookup_global_symbol): Update decl.

diff --git a/gdb/symtab.h b/gdb/symtab.h
index c967c62..9b3ea80 100644 (file)
--- a/gdb/symtab.h
+++ b/gdb/symtab.h
@@ -1104,6 +1104,14 @@ extern struct symbol *lookup_static_symbol (const char *name,
                                            const domain_enum domain);
 
 /* Lookup a symbol in all files' global blocks.
+
+   If BLOCK is non-NULL then it is used for two things:
+   1) If a target-specific lookup routine for libraries exists, then use the
+      routine for the objfile of BLOCK, and
+   2) The objfile of BLOCK is used to assist in determining the search order
+      if the target requires it.
+      See gdbarch_iterate_over_objfiles_in_search_order.
+
    Upon success sets BLOCK_FOUND and fixes up the symbol's section
    if necessary.  */