magit-commit-p: Future-proof docstring

1 files changed, 3 insertions, 2 deletions

diff --git a/lisp/magit-git.el b/lisp/magit-git.el
index 2bb6c0e..ee52c2a 100644
--- a/lisp/magit-git.el
+++ b/lisp/magit-git.el
@@ -1451,9 +1451,10 @@ string \"true\", otherwise return nil."
   (magit-git-string "rev-parse" "--verify" rev))
 
 (defun magit-commit-p (rev)
-  "Return commit oid for REV if it can be dereferences as a commit.
+  "Return non-nil if REV can be dereferences as a commit.
 Otherwise return nil.  Use `magit-commit-oid' if you actually need
-the oid; eventually this function will return t instead of the oid."
+the oid; eventually this function will return t instead of the oid,
+as it curently does for backward compatibility."
   ;; TODO Return t instead of the oid.
   (magit-rev-verify (magit--rev-dereference rev)))