* symtab.c (iterate_over_some_symtabs): Add comment.

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 678af3d..015f13c 100644 (file)
--- a/gdb/ChangeLog
+++ b/gdb/ChangeLog
@@ -1,5 +1,7 @@
 2013-07-29  Doug Evans  <dje@google.com>
 
+       * symtab.c (iterate_over_some_symtabs): Add comment.
+
        * symtab.c (iterate_over_some_symtabs): Fix indentation.
 
 2013-07-27  Yao Qi  <yao@codesourcery.com>

diff --git a/gdb/symtab.c b/gdb/symtab.c
index ee21fe9..00662ea 100644 (file)
--- a/gdb/symtab.c
+++ b/gdb/symtab.c
@@ -186,6 +186,9 @@ compare_filenames_for_search (const char *filename, const char *search_name)
 /* Check for a symtab of a specific name by searching some symtabs.
    This is a helper function for callbacks of iterate_over_symtabs.
 
+   If NAME is not absolute, then REAL_PATH is NULL
+   If NAME is absolute, then REAL_PATH is the gdb_realpath form of NAME.
+
    The return value, NAME, REAL_PATH, CALLBACK, and DATA
    are identical to the `map_symtabs_matching_filename' method of
    quick_symbol_functions.
@@ -230,7 +233,6 @@ iterate_over_some_symtabs (const char *name,
 
       /* If the user gave us an absolute path, try to find the file in
         this symtab and use its absolute path.  */
-
       if (real_path != NULL)
        {
          const char *fullname = symtab_to_fullname (s);