(vc-call): Add doc string.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index 879d9646e04cc4c778e667d5d94f874cbcbef88e..4ec6319b06b746e12bf739f1ba056d821cea28c6 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,3 +1,9 @@
+2007-08-06  Jason Rumney  <jasonr@gnu.org>
+
+       * menu-bar.el (menu-bar-vc-filter): Use vc-call-backend.
+
+       * vc-hooks.el (vc-call): Add doc string.
+
 2007-08-06  Michael Albinus  <michael.albinus@gmx.de>
 
        * net/ange-ftp.el (ange-ftp-hook-function): Catch also errors in

diff --git a/lisp/vc-hooks.el b/lisp/vc-hooks.el
index 09001e59691720e140de03767e3c13b1e1fe7725..d38bc00046548089426bce1e9ecaf0bbc891b7b0 100644 (file)
--- a/lisp/vc-hooks.el
+++ b/lisp/vc-hooks.el
@@ -279,7 +279,10 @@ It is usually called via the `vc-call' macro."
      (t                (apply f args)))))
 
 (defmacro vc-call (fun file &rest args)
-  ;; BEWARE!! `file' is evaluated twice!!
+  "A convenience macro for calling VC backend functions.
+Functions called by this macro must accept FILE as the first argument.
+ARGS specifies any additional arguments. FUN should be unquoted.
+BEWARE!! `file' is evaluated twice!!"
   `(vc-call-backend (vc-backend ,file) ',fun ,file ,@args))
 \f
 (defsubst vc-parse-buffer (pattern i)