# HG changeset patch
# User Dan Nicolaescu <dann@ics.uci.edu>
# Date 1203435885 0
# Node ID 81890a88d53dad2da7f5ab71f8e4ac18fe87bbf8
# Parent  dfdc2f5061b37977d07ba6fb7b35d652e3db5ac3
(dir-status): Add a brief description.

diff -r dfdc2f5061b3 -r 81890a88d53d lisp/ChangeLog
--- a/lisp/ChangeLog	Tue Feb 19 12:26:40 2008 +0000
+++ b/lisp/ChangeLog	Tue Feb 19 15:44:45 2008 +0000
@@ -1,3 +1,7 @@
+2008-02-19  Dan Nicolaescu  <dann@ics.uci.edu>
+
+	* vc.el (dir-status): Add a brief description.
+
 2008-02-19  Thien-Thi Nguyen  <ttn@gnuvola.org>
 
 	* vc-hooks.el (vc-find-root): Take optional arg INVERT.
diff -r dfdc2f5061b3 -r 81890a88d53d lisp/vc.el
--- a/lisp/vc.el	Tue Feb 19 12:26:40 2008 +0000
+++ b/lisp/vc.el	Tue Feb 19 15:44:45 2008 +0000
@@ -167,6 +167,19 @@
 ;;   in older versions this method was not required to recurse into
 ;;   subdirectories.)
 ;;
+;; - dir-status (dir update-function status-buffer)
+;;
+;;   Produce RESULT: a list of conses of the form (file . vc-state)
+;;   for the files in DIR.  If a command needs to be run to compute
+;;   this list, it should be run asynchronously.  When RESULT is
+;;   computed, it should be passed back by doing:
+;;       (funcall UPDATE-FUNCTION RESULT STATUS-BUFFER)
+;;   This function is used by vc-status, a replacement for vc-dired.
+;;   vc-status is still under development, and is NOT feature
+;;   complete.  As such, the requirements for this function might
+;;   change.
+;;   This is a replacement for dir-state.
+;;
 ;; * working-revision (file)
 ;;
 ;;   Return the working revision of FILE.  This is the revision fetched