From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Sun, 1 Nov 2020 12:55:29 +0000 (+0100)
Subject: Doc string clarification for cl-some
X-Git-Tag: emacs-28.0.90~5295
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=7a3d8559c9abac17c4ef2b951554912a87a9995d;p=emacs.git

Doc string clarification for cl-some

* lisp/emacs-lisp/cl-extra.el (cl-some): Clarify the return value
(bug#44330).
---

diff --git a/lisp/emacs-lisp/cl-extra.el b/lisp/emacs-lisp/cl-extra.el
index 23c784f9f8e..d3159a37683 100644
--- a/lisp/emacs-lisp/cl-extra.el
+++ b/lisp/emacs-lisp/cl-extra.el
@@ -201,8 +201,11 @@ the elements themselves.
 
 ;;;###autoload
 (defun cl-some (cl-pred cl-seq &rest cl-rest)
-  "Return true if PREDICATE is true of any element of SEQ or SEQs.
-If so, return the true (non-nil) value returned by PREDICATE.
+  "Say whether PREDICATE is true for any element in the SEQ sequences.
+More specifically, the return value of this function will be the
+same as the first return value of PREDICATE where PREDICATE has a
+non-nil value.
+
 \n(fn PREDICATE SEQ...)"
   (if (or cl-rest (nlistp cl-seq))
       (catch 'cl-some