* lisp/vc/vc.el: Improve `dir-status-files' description

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 035f476aa80f90d6d7da9b7219f55379c10469fa..39f09f46c0960db5086e6379014aa6a5e3a15216 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,7 @@
 2014-12-17  Dmitry Gutov  <dgutov@yandex.ru>
 
+       * vc/vc.el: Improve `dir-status-files' description.
+
        * emacs-lisp/package.el (package--list-loaded-files): Don't call
        file-truename on load-history elements (bug#19390).
 

diff --git a/lisp/vc/vc.el b/lisp/vc/vc.el
index 954b3cfeb027e004f69ea8ce454721d465ad003c..6283dc8d782e8f09a15b3b325bc47351ee97f450 100644 (file)
--- a/lisp/vc/vc.el
+++ b/lisp/vc/vc.el
@@ -133,10 +133,13 @@
 ;; - dir-status-files (dir files update-function)
 ;;
 ;;   Produce RESULT: a list of lists of the form (FILE VC-STATE EXTRA)
-;;   for FILES in DIR.  If FILES is nil. report on all files in DIR.
+;;   for FILES in DIR.  If FILES is nil, report on all files in DIR.
 ;;   (It is OK, though possibly inefficient, to ignore the FILES argument
 ;;   and always report on all files in DIR.)
 ;;
+;;   If FILES is non-nil, this function should report on all requested
+;;   files, including up-to-date or ignored files.
+;;
 ;;   EXTRA can be used for backend specific information about FILE.
 ;;   If a command needs to be run to compute this list, it should be
 ;;   run asynchronously using (current-buffer) as the buffer for the
@@ -153,10 +156,6 @@
 ;;   the following functions might be needed: `dir-extra-headers',
 ;;   `dir-printer', and `extra-dir-menu'.
 ;;
-;;   This function should report on all requested files, including
-;;   up-to-date or ignored files. If it is not provided, the default is to
-;;   consider that all files are in 'up-to-date state.
-;;
 ;; - dir-extra-headers (dir)
 ;;
 ;;   Return a string that will be added to the *vc-dir* buffer header.