org-maint-check-for-new: Rewrite docstring

1 files changed, 5 insertions, 4 deletions

diff --git a/org-maint.el b/org-maint.el
index fe411fe..af1f7a1 100644
--- a/org-maint.el
+++ b/org-maint.el
@@ -64,10 +64,11 @@ If APPLY is non-nil, use 'git apply' instead of 'git am'."
         (user-error "Next revision item not found"))))
 
 (defun org-maint-check-for-new ()
-  "Check for new commits to backport.
-The last commit found is assumed to be the return value of
-`org-maint-rev-from-next-item', and Emacs ref name that should be
-checked is taken from the Org \"ref\" property."
+  "Check for new commits in the Emacs repository to port.
+Determine \"new\" commits by looking for commits that 1) touch
+Org files, 2) are contained in the Emacs reference specified by
+the Org \"ref\" property, and 3) are _not_ included in the
+revision returned by `org-maint-rev-from-next-item'."
   (interactive)
   (let ((ref (or (org-entry-get (point) "ref")
                  (user-error "No reference found")))