[Emacs-diffs] master 1fa431d: * lisp/vc/add-log.el (change-log-directory-files, find-change-log):

[Glenn Morris]

branch: master
commit 1fa431d3145ffea33fb3272b5d09f961a17974f1
Author: Glenn Morris <address@hidden>
Commit: Glenn Morris <address@hidden>

    * lisp/vc/add-log.el (change-log-directory-files, find-change-log):
    Doc tweaks.
---
 lisp/vc/add-log.el |    8 ++++++--
 1 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/lisp/vc/add-log.el b/lisp/vc/add-log.el
index ceb0d42..112bc7b 100644
--- a/lisp/vc/add-log.el
+++ b/lisp/vc/add-log.el
@@ -172,7 +172,7 @@ Note: The search is conducted only within 10%, at the 
beginning of the file."
   :group 'change-log)
 
 (defcustom change-log-directory-files '(".bzr" ".git" ".hg" ".svn")
-  "List of files that cause ChangeLog search to stop in containing directory.
+  "List of files that cause `find-change-log' to stop in containing directory.
 This applies if no pre-existing ChangeLog is found.  If nil, then in such
 a case simply use the directory containing the changed file."
   :version "25.2"
@@ -699,7 +699,11 @@ If `change-log-default-name' is nil, behave as though it 
were \"ChangeLog\"
 
 If `change-log-default-name' contains a leading directory component, then
 simply find it in the current directory.  Otherwise, search in the current
-directory and its successive parents for a file so named.
+directory and its successive parents for a file so named.  Stop at the first
+such file that exists (or has a buffer visiting it), or the first directory
+that contains any of `change-log-directory-files'.  If no match is found,
+use the current directory.  To override the choice of this function,
+simply create an empty ChangeLog file first by hand in the desired place.
 
 Once a file is found, `change-log-default-name' is set locally in the
 current buffer to the complete file name.