From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Rudolf =?UTF-8?Q?Adamkovi=C4=8D?= via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#59286: Documentation for seq-count Date: Wed, 16 Nov 2022 18:18:22 +0100 Message-ID: References: Reply-To: Rudolf =?UTF-8?Q?Adamkovi=C4=8D?= Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="14603"; mail-complaints-to="usenet@ciao.gmane.io" To: Heime , 59286@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Nov 16 18:19:35 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1ovM4V-0003Z8-0Y for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 16 Nov 2022 18:19:35 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ovM40-00031i-K4; Wed, 16 Nov 2022 12:19:04 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ovM3y-00031V-Sq for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2022 12:19:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ovM3y-00022i-Kb for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2022 12:19:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ovM3y-00008l-Fj for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2022 12:19:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Rudolf =?UTF-8?Q?Adamkovi=C4=8D?= Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 16 Nov 2022 17:19:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 59286 X-GNU-PR-Package: emacs Original-Received: via spool by 59286-submit@debbugs.gnu.org id=B59286.1668619114495 (code B ref 59286); Wed, 16 Nov 2022 17:19:02 +0000 Original-Received: (at 59286) by debbugs.gnu.org; 16 Nov 2022 17:18:34 +0000 Original-Received: from localhost ([127.0.0.1]:58030 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovM3W-00007v-GY for submit@debbugs.gnu.org; Wed, 16 Nov 2022 12:18:34 -0500 Original-Received: from mr85p00im-hyfv06021401.me.com ([17.58.23.190]:54632) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovM3U-00007g-T2 for 59286@debbugs.gnu.org; Wed, 16 Nov 2022 12:18:33 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=me.com; s=1a1hai; t=1668619106; bh=5oFQl6ygtfFb0Uf83279TeUrUVsduBNMAa+Q/MUMeDw=; h=From:To:Subject:Date:Message-ID:MIME-Version:Content-Type; b=LSiK4ZhTyCHCozE10rH/jwfjJmQ/Poc6znl3UdJRFLJPjhqApqityhvVcdpYHs/VD eJadpGCZY3Yb41b6MMY1hQbagVxFw8y5D5G92seafIE8DyQgk970JUCH/7r3248V6e sgtjQUfqJOw8t3xWvvbAc9yl2GKw+nYiUBv8spvoqXeas+qhNDFpo8klph9bTXZ7jo cuN5DHFSbIpaQ6yo+W3937u5EUT9GfAomaNPj7wCt3dlVSpn8QqSzEPc+yeXkbDjxV xccx7ZVh04Q760Ps6W+5ASKbDEvZuXQi5IAI+/+Sa66GxDCHOVjlGd4D/C2Z2bOb5j rPQWmuab3yqgQ== Original-Received: from Rudolfs-MacBook-Air.local (mr38p00im-dlb-asmtp-mailmevip.me.com [17.57.152.18]) by mr85p00im-hyfv06021401.me.com (Postfix) with ESMTPSA id 72CD23038E16; Wed, 16 Nov 2022 17:18:25 +0000 (UTC) In-Reply-To: X-Proofpoint-ORIG-GUID: dotiWWU-DUq-7hTrYsyovT4JN2tLnhyT X-Proofpoint-GUID: dotiWWU-DUq-7hTrYsyovT4JN2tLnhyT X-Proofpoint-Virus-Version: vendor=fsecure engine=1.1.170-22c6f66c430a71ce266a39bfe25bc2903e8d5c8f:6.0.138, 18.0.572, 17.11.62.513.0000000 definitions=2020-02-14_11:2020-02-14_02, 2020-02-14_11, 2021-12-02_01 signatures=0 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 phishscore=0 suspectscore=0 mlxscore=0 mlxlogscore=556 malwarescore=0 spamscore=0 clxscore=1011 bulkscore=0 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2209130000 definitions=main-2211160120 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:248030 Archived-At: Heime via "Bug reports for GNU Emacs, the Swiss army knife of text editors" writes: > A description that is quite undecipherable. I have recently used this function for the first time (when contributing to Org), and I found its description *exceptionally* clear. What do you find undecipherable? P.S. #1 It helps to know that "PRED" stands for the English word PREDICATE. Experienced users and native speakers may laugh, but the fact that "BEG" does not mean "to beg" but "the beginning", adds completely unnecessary cognitive overhead to some. The same applies to "PRED". (The Scheme standard, for example, also uses shorthand forms, such as "obj", but it lists all of them, right at the beginning. Perhaps Emacs has such a list too? If so, the help browser should use it to assist the user to make sense of these non-words.) P.S. #2 When I used this function, I wished it would take ELEMENT-OR-PREDICATE, so that (seq-count 2 '(0 2 2 2 0)) =3D> 3, and I still wonder if Emacs comes with any such function. (I ended up using `equal' wrapped in the PREDICATE.) Rudy --=20 "Mathematics takes us still further from what is human into the region of absolute necessity, to which not only the actual world, but every possible world, must conform." -- Bertrand Russell, 1902 Rudolf Adamkovi=C4=8D [he/him] Studenohorsk=C3=A1 25 84103 Bratislava Slovakia