* symtab.c (iterate_over_some_symtabs): Add comment.

diff --git a/gdb/ChangeLog b/gdb/ChangeLog
index 678af3d5ec49e0984bff473584d3f21c7f326a70..015f13cc0d00f056f146c1f6619569e92b4daf94 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 ee21fe9804e2208cc3b4c3f463eab84e425c73c1..00662eafeb2973fbad213b12e5221839880460d0 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);