From: Doug Evans <xdje42@gmail.com>
Date: Sun, 11 Jan 2015 19:36:36 +0000 (-0800)
Subject: Improve comments for symbol_cache_mark_{not_,}found.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=400678a494713abf8f7ea2367f213109a2c4b886;p=binutils-gdb.git

Improve comments for symbol_cache_mark_{not_,}found.

gdb/ChangeLog:

	* symtab.c (symbol_cache_mark_found): Improve function comment.
	Rename parameter objfile to objfile_context.
	(symbol_cache_mark_not_found): Ditto.
---

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 1bd2b46cd65..de5eef86bd4 100644
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,3 +1,9 @@
+2015-01-11  Doug Evans  <xdje42@gmail.com>
+
+	* symtab.c (symbol_cache_mark_found): Improve function comment.
+	Rename parameter objfile to objfile_context.
+	(symbol_cache_mark_not_found): Ditto.
+
 2015-01-10  Doug Evans  <xdje42@gmail.com>
 
 	Add symbol lookup cache.
diff --git a/gdb/symtab.c b/gdb/symtab.c
index 71931315e07..698de5f8eee 100644
--- a/gdb/symtab.c
+++ b/gdb/symtab.c
@@ -1426,12 +1426,16 @@ symbol_cache_clear_slot (struct symbol_cache_slot *slot)
   slot->state = SYMBOL_SLOT_UNUSED;
 }
 
-/* Mark SYMBOL as found in SLOT.  */
+/* Mark SYMBOL as found in SLOT.
+   OBJFILE_CONTEXT is the current objfile when the lookup was done, or NULL
+   if it's not needed to distinguish lookups (STATIC_BLOCK).  It is *not*
+   necessarily the objfile the symbol was found in.  */
 
 static void
 symbol_cache_mark_found (struct block_symbol_cache *bsc,
 			 struct symbol_cache_slot *slot,
-			 struct objfile *objfile, struct symbol *symbol)
+			 struct objfile *objfile_context,
+			 struct symbol *symbol)
 {
   if (bsc == NULL)
     return;
@@ -1441,11 +1445,13 @@ symbol_cache_mark_found (struct block_symbol_cache *bsc,
       symbol_cache_clear_slot (slot);
     }
   slot->state = SYMBOL_SLOT_FOUND;
-  slot->objfile_context = objfile;
+  slot->objfile_context = objfile_context;
   slot->value.found = symbol;
 }
 
-/* Mark symbol NAME, DOMAIN as not found in SLOT.  */
+/* Mark symbol NAME, DOMAIN as not found in SLOT.
+   OBJFILE_CONTEXT is the current objfile when the lookup was done, or NULL
+   if it's not needed to distinguish lookups (STATIC_BLOCK).  */
 
 static void
 symbol_cache_mark_not_found (struct block_symbol_cache *bsc,