* lisp/files.el (locate-dominating-file): Doc fix.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 7bf2ba1bcc2f31ef3c4a06c8c3328571cff6ef9c..76166b50c0faea8bc056d9a433bc72d5716c2c67 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,7 @@
+2012-03-06  Glenn Morris  <rgm@gnu.org>
+
+       * files.el (locate-dominating-file): Doc fix.
+
 2012-03-06  Adam Spiers  <emacs@adamspiers.org>  (tiny change)
 
        * calendar/calendar.el (calendar-set-mode-line):

diff --git a/lisp/files.el b/lisp/files.el
index 88ebb9eaab43a2a28f06ffe28764ffeee67eb78b..d9a3e4b0f796eabb65c0176efbc8d479acd13ddd 100644 (file)
--- a/lisp/files.el
+++ b/lisp/files.el
@@ -880,7 +880,10 @@ or mount points potentially requiring authentication as a different user.")
 (defun locate-dominating-file (file name)
   "Look up the directory hierarchy from FILE for a file named NAME.
 Stop at the first parent directory containing a file NAME,
-and return the directory.  Return nil if not found."
+and return the directory.  Return nil if not found.
+
+This function only tests if FILE exists.  If you care about whether
+it is readable, regular, etc., you should test the result."
   ;; We used to use the above locate-dominating-files code, but the
   ;; directory-files call is very costly, so we're much better off doing
   ;; multiple calls using the code in here.