2013-03-28  Doug Evans  <dje@google.com>
 
+       * symfile.c (find_separate_debug_file): Add comment.
+       (terminate_after_last_dir_separator): Tweak comment.
+
        * dwarf2read.c (create_partial_symtab): Add forward decl.
        (create_partial_symtab): Move to be closer to other psymtab functions.
        (process_psymtab_comp_unit_reader, process_psymtab_comp_unit): Ditto.
 
 /* Find a separate debuginfo file for OBJFILE, using DIR as the directory
    where the original file resides (may not be the same as
    dirname(objfile->name) due to symlinks), and DEBUGLINK as the file we are
-   looking for.  Returns the name of the debuginfo, of NULL.  */
+   looking for.  CANON_DIR is the "realpath" form of DIR.
+   DIR must contain a trailing '/'.
+   Returns the path of the file with separate debug info, of NULL.  */
 
 static char *
 find_separate_debug_file (const char *dir,
   return NULL;
 }
 
-/* Modify PATH to contain only "directory/" part of PATH.
+/* Modify PATH to contain only "[/]directory/" part of PATH.
    If there were no directory separators in PATH, PATH will be empty
    string on return.  */