GNU bug report logs - #44330
26.3; doc string of `cl-some'

Previous Next

Full log

View this message in rfc822 format

From: Drew Adams <drew.adams <at> oracle.com>
To: 44330 <at> debbugs.gnu.org
Subject: bug#44330: 26.3; doc string of `cl-some'
Date: Fri, 30 Oct 2020 08:54:12 -0700 (PDT)

"Return true if PREDICATE is true of any element of SEQ or SEQs.
If so, return the true (non-nil) value returned by PREDICATE."
                                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^

The second sentence is meaningless/underspecified.  If the function
stops as soon as it finds the first element for which PREDICATE is
true then the doc should say that it returns the value returned by
PREDICATE _for that element_.

Without specifying, in some way, for which element the application of
PREDICATE returns non-nil, "the value returned by PREDICATE" has no
meaning.

In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32)
 of 2019-08-29
Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd
Windowing system distributor `Microsoft Corp.', version 10.0.18362
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.