diff lisp/vc-git.el @ 107810:03ef65bf2e25

Improve documentation comments.
author Eric S. Raymond <esr@thyrsus.com>
date Fri, 09 Apr 2010 10:17:52 -0400
parents d47e1fb98df3
children 2c6eaa7826c7
line wrap: on
line diff
--- a/lisp/vc-git.el	Fri Apr 09 00:14:33 2010 +0300
+++ b/lisp/vc-git.el	Fri Apr 09 10:17:52 2010 -0400
@@ -171,7 +171,14 @@
 
 (defun vc-git-state (file)
   "Git-specific version of `vc-state'."
-  ;; FIXME: This can't set 'ignored yet
+  ;; FIXME: This can't set 'ignored or 'conflict yet
+  ;; The 'ignored state could be detected with `git ls-files -i -o
+  ;; --exclude-standard` It also can't set 'needs-update or
+  ;; 'needs-merge. The rough equivalent would be that upstream branch
+  ;; for current branch is in fast-forward state i.e. current branch
+  ;; is direct ancestor of corresponding upstream branch, and the file
+  ;; was modified upstream.  But we can't check that without a network
+  ;; operation.
   (if (not (vc-git-registered file))
       'unregistered
     (vc-git--call nil "add" "--refresh" "--" (file-relative-name file))