From unknown Mon Aug 18 19:35:31 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#59286 <59286@debbugs.gnu.org> To: bug#59286 <59286@debbugs.gnu.org> Subject: Status: Documentation for seq-count Reply-To: bug#59286 <59286@debbugs.gnu.org> Date: Tue, 19 Aug 2025 02:35:31 +0000 retitle 59286 Documentation for seq-count reassign 59286 emacs submitter 59286 Heime severity 59286 minor thanks From debbugs-submit-bounces@debbugs.gnu.org Tue Nov 15 11:19:09 2022 Received: (at submit) by debbugs.gnu.org; 15 Nov 2022 16:19:09 +0000 Received: from localhost ([127.0.0.1]:55113 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ouyeS-0007JV-UP for submit@debbugs.gnu.org; Tue, 15 Nov 2022 11:19:09 -0500 Received: from lists.gnu.org ([209.51.188.17]:52216) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ouyeP-0007JM-MW for submit@debbugs.gnu.org; Tue, 15 Nov 2022 11:19:07 -0500 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 1ouyeP-0008TI-7W for bug-gnu-emacs@gnu.org; Tue, 15 Nov 2022 11:19:05 -0500 Received: from mail-4325.protonmail.ch ([185.70.43.25]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ouyeN-0007Vr-1m for bug-gnu-emacs@gnu.org; Tue, 15 Nov 2022 11:19:04 -0500 Date: Tue, 15 Nov 2022 16:18:46 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail3; t=1668529139; x=1668788339; bh=obJOMUv/olrAXkQpQE61aJXhprswyDko2MCqnYMeXyY=; h=Date:To:From:Subject:Message-ID:Feedback-ID:From:To:Cc:Date: Subject:Reply-To:Feedback-ID:Message-ID:BIMI-Selector; b=aKgbQl6ab4yaipMnoHw3CNQYmTFFHYEiNJHSLPbq/7ittJDzpuuc7xML3eaAfEQGC VUyK6cOeltsPnfAgvYeE7vRoeTymK60kOjLN3uojEUKHamO0D2SLc8arXZ+ZmTBUml /itpsYNpWAkX3pl5ELIPMVdgDUcqcYT50s2cl+129cvEbaMFdOaOxwat/x3xhjlGI3 GS+2unIN1qIs6ArjVY+0WYlMzTkCpKDpG8Z3eCLIG0azRzmbRrh96+vqdUrnHc9le0 Ub5YftoqWnGCyVpWtpEAVSYvlqV3t7/sByXM2qW4rRhMZRt8TAaqc1gYnFvYfKfx+6 iMQvy0pKhjMkQ== To: "bug-gnu-emacs@gnu.org" From: Heime Subject: Documentation for seq-count Message-ID: Feedback-ID: 57735886:user:proton MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=185.70.43.25; envelope-from=heimeborgia@protonmail.com; helo=mail-4325.protonmail.ch X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -1.3 (-) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -2.3 (--) Have scrutinised the documentation for "seq-count". A description that is = quite undecipherable. (seq-count PRED SEQUENCE) Return the number of elements for which (PRED element) is non-nil in SEQUEN= CE. From debbugs-submit-bounces@debbugs.gnu.org Wed Nov 16 12:18:34 2022 Received: (at 59286) by debbugs.gnu.org; 16 Nov 2022 17:18:34 +0000 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 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== 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) From: Rudolf =?utf-8?Q?Adamkovi=C4=8D?= To: Heime , 59286@debbugs.gnu.org Subject: Re: bug#59286: Documentation for seq-count In-Reply-To: References: Date: Wed, 16 Nov 2022 18:18:22 +0100 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Proofpoint-ORIG-GUID: dotiWWU-DUq-7hTrYsyovT4JN2tLnhyT X-Proofpoint-GUID: dotiWWU-DUq-7hTrYsyovT4JN2tLnhyT X-Proofpoint-Virus-Version: =?UTF-8?Q?vendor=3Dfsecure_engine=3D1.1.170-22c6f66c430a71ce266a39bfe25bc?= =?UTF-8?Q?2903e8d5c8f:6.0.138,18.0.572,17.11.62.513.0000000_definitions?= =?UTF-8?Q?=3D2020-02-14=5F11:2020-02-14=5F02,2020-02-14=5F11,2021-12-02?= =?UTF-8?Q?=5F01_signatures=3D0?= 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-Spam-Score: -0.7 (/) X-Debbugs-Envelope-To: 59286 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.7 (-) 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 From debbugs-submit-bounces@debbugs.gnu.org Wed Nov 16 13:00:21 2022 Received: (at 59286) by debbugs.gnu.org; 16 Nov 2022 18:00:21 +0000 Received: from localhost ([127.0.0.1]:58066 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovMhw-0001BK-38 for submit@debbugs.gnu.org; Wed, 16 Nov 2022 13:00:20 -0500 Received: from mail-4318.protonmail.ch ([185.70.43.18]:19447) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovMhg-00018v-M4 for 59286@debbugs.gnu.org; Wed, 16 Nov 2022 13:00:18 -0500 Date: Wed, 16 Nov 2022 17:59:44 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail3; t=1668621597; x=1668880797; bh=nMJDtm1HKGAkKfRroZ0tDe4FgawD7IpHv8+wSrwgtzk=; h=Date:To:From:Cc:Subject:Message-ID:In-Reply-To:References: Feedback-ID:From:To:Cc:Date:Subject:Reply-To:Feedback-ID: Message-ID:BIMI-Selector; b=UUeKrCgnadgvMijNVg8R66fiSzCHFfHbXE3rtExCJy9ITja/hipxQ8m6aHwTRHg9T ipbcHlhO7afC/DQZ+6DzAZ/ri0qGW0jvsH+QYPM4/kqvKhA/wdJ77yHbs3LO+SoA7j sPQpStPtbNvvBN6TXgHCcwm4pM/aBA1WH+RRvHPXL2N0ZeXm1R239vuIX3lvAiriDn TFZrLCfpynqeqMxoph5rVA+D7HLrbz3QtJExKgLZlQEJghxggWiz+b80eCJZd9ya8O i7FleqO3aTc9DVVsWj2ZMbDrFm0xy6eC8WboH/7Y7a5sb4WJDL3GOIHFGeOYiszCyl 4sBOTXhfY3qDg== To: =?utf-8?Q?Rudolf_Adamkovi=C4=8D?= From: Heime Subject: Re: bug#59286: Documentation for seq-count Message-ID: In-Reply-To: References: Feedback-ID: 57735886:user:proton MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 59286 Cc: 59286@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) ------- Original Message ------- On Wednesday, November 16th, 2022 at 5:18 PM, Rudolf Adamkovi=C4=8D via "Bu= g reports for GNU Emacs, the Swiss army knife of text editors" wrote: > Heime via "Bug reports for GNU Emacs, the Swiss army knife of text > editors" bug-gnu-emacs@gnu.org writes: >=20 > > A description that is quite undecipherable. >=20 >=20 > 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? >=20 > P.S. #1 >=20 > It helps to know that "PRED" stands for the English word PREDICATE. Fine, but how do you use that? No information, no example. Seems to me th= at authors of documentation willfully avoid showing examples or where to find = them. > 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". >=20 > (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.) >=20 > P.S. #2 >=20 > When I used this function, I wished it would take ELEMENT-OR-PREDICATE, > so that >=20 > (seq-count 2 '(0 2 2 2 0)) =3D> 3, >=20 >=20 > and I still wonder if Emacs comes with any such function. >=20 > (I ended up using `equal' wrapped in the PREDICATE.) >=20 > Rudy > -- > "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 >=20 > Rudolf Adamkovi=C4=8D salutis@me.com [he/him] >=20 > Studenohorsk=C3=A1 25 > 84103 Bratislava > Slovakia > From debbugs-submit-bounces@debbugs.gnu.org Wed Nov 16 13:09:53 2022 Received: (at 59286) by debbugs.gnu.org; 16 Nov 2022 18:09:53 +0000 Received: from localhost ([127.0.0.1]:58097 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovMrA-0001Qg-TT for submit@debbugs.gnu.org; Wed, 16 Nov 2022 13:09:53 -0500 Received: from mail-pf1-f169.google.com ([209.85.210.169]:35660) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovMr7-0001QR-9X for 59286@debbugs.gnu.org; Wed, 16 Nov 2022 13:09:50 -0500 Received: by mail-pf1-f169.google.com with SMTP id k15so18245731pfg.2 for <59286@debbugs.gnu.org>; Wed, 16 Nov 2022 10:09:49 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:mime-version:date:message-id:from:to:cc :subject:date:message-id:reply-to; bh=UknwBMYZk0q66wJC2ySVW1BfASFtEYFgdJ476H/N0DM=; b=URI47ybBFtPZJGMKQaTF+ELujv+ASpvce36d4Tf7SiyhhPIECxD+VQJNMyun6A5fE1 pv8IASJ9sgZeIbolc8mndTlw9IG0ZdDOTTdJO6t9GJyW+buFp3Tl6Je1ob08CC9V8QSh JnkcvDItoD7dJkOaOXrVvbSEfCb0+QN+s3cfKaLVbSO2KSMNIb0wCFP3512P4Bs6/iXB rzAo4i5TvyIy8l5Rdu9rZc8PX4unAelmoXVKOUsM21yrAW3s1L5vzloFA0UVFA33vYyX DXmiSiyUrgN9+sPVRCh3FWKIAdyv6W0lfMTmUHyTH4e5uwwmGRFwNU//bKoszW57VkKF 09vQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:in-reply-to:from:content-language :references:cc:to:subject:mime-version:date:message-id :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=UknwBMYZk0q66wJC2ySVW1BfASFtEYFgdJ476H/N0DM=; b=f36/kGYlgM7zPpFyPXioQq3zIu6trupA3eD2JWV2oIndeNnRiuWFoItJMABaSPAAof YU5wKANWsc/cvFnTMyc8JP18i0Ls4thl+UiKCy4MgiwLjefo5NH8nxXslaeiDoa6eKDc OhZGHXse3eCzzqV9Alxyz5bBd06Qh/I6fED03yl+KTjNOK9dIDFCWBa0wQoOcTEaygR3 fEucc+flKgabM/N34zpvgRxVAj+5G2pFi8C4xXKkluapWMr54FAhwdf8mT36CI1ukZ+g 9wmFI6Aj9Lxm7ivnNEUBobfsFQqNB5V0qQ6wrAh1Tnamgi7gMYntuPGBAajwGDemVeQO PlvQ== X-Gm-Message-State: ANoB5pkSL5sTzjHZuElEecs30Hu8+bGzwRdITHl3HXkuMX07/oyFiRlj ZvUqml9P8QbwpLctURrHGRI= X-Google-Smtp-Source: AA0mqf68RNpsuZxJz2jp1JQEdYPbo8pRZZoJtpH40ARRSuxgiE1AnOzeYvpPU5yCWHfg/oAmh2+ISg== X-Received: by 2002:a63:1403:0:b0:46f:53cb:65b5 with SMTP id u3-20020a631403000000b0046f53cb65b5mr20644269pgl.507.1668622183248; Wed, 16 Nov 2022 10:09:43 -0800 (PST) Received: from [192.168.1.2] (cpe-76-168-148-233.socal.res.rr.com. [76.168.148.233]) by smtp.googlemail.com with ESMTPSA id t7-20020a635347000000b0046fe244ed6esm9911622pgl.23.2022.11.16.10.09.42 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 16 Nov 2022 10:09:42 -0800 (PST) Message-ID: <8a927541-93b8-1a44-43df-77251280ffbe@gmail.com> Date: Wed, 16 Nov 2022 10:09:39 -0800 MIME-Version: 1.0 Subject: Re: bug#59286: Documentation for seq-count To: Heime , =?UTF-8?Q?Rudolf_Adamkovi=c4=8d?= References: Content-Language: en-US From: Jim Porter In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 59286 Cc: 59286@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) On 11/16/2022 9:59 AM, Heime via Bug reports for GNU Emacs, the Swiss army knife of text editors wrote: > Fine, but how do you use that? No information, no example. Seems to me that > authors of documentation willfully avoid showing examples or where to find them. In a *Help* buffer, just below the docstring is this message: Other relevant functions are documented in the _sequence_ group. Clicking on "sequence" takes you to shortdocs, which shows an example:  (seq-count #'numberp '(1 b c 4)) ⇒ 2 Maybe the "Other relevant functions" wording could be improved so that it's clearer though. It doesn't really indicate that you'll find more details about 'seq-count' in particular, just "other relevant functions". Something like, "See the _sequence_ group for more information on this and other relevant functions," maybe? From debbugs-submit-bounces@debbugs.gnu.org Wed Nov 16 13:51:03 2022 Received: (at 59286) by debbugs.gnu.org; 16 Nov 2022 18:51:03 +0000 Received: from localhost ([127.0.0.1]:58118 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovNV1-0004gb-Ja for submit@debbugs.gnu.org; Wed, 16 Nov 2022 13:51:03 -0500 Received: from mail-40130.protonmail.ch ([185.70.40.130]:43189) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovNUw-0004g2-8Y for 59286@debbugs.gnu.org; Wed, 16 Nov 2022 13:51:02 -0500 Date: Wed, 16 Nov 2022 18:50:41 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=protonmail.com; s=protonmail3; t=1668624651; x=1668883851; bh=ks1++9MAxznJW9Y1GMu8c92bzcgNo5yS0a+VEqZVW/U=; h=Date:To:From:Cc:Subject:Message-ID:In-Reply-To:References: Feedback-ID:From:To:Cc:Date:Subject:Reply-To:Feedback-ID: Message-ID:BIMI-Selector; b=VO0Zsl2lFf8UQqFvg5hR/EFPXbd3AFgV+MKQKl9mr03ytCmGQIV2WeWXXHabiDq+l t5L51RPisAFDWvDeOcPKvnIo79rStRQ6Orq9+NvE7Msq54gFKJgw1bPTJ2R3BZbyMg Fx518H5x/p8AzlOqpqNRBv5S0I21yTI2LrI+4dbi21dRLiCnmGrKvJ6cp4mHrvO+eH 2LXzQGmtmnKMwedmrpc8boD1LOFsmKQfGuuHmxTDTfdKjYHJul2+4n1eA5bI7Cw4Kp HMCYxdU9LWXiSWLtNfnSk2otedmY0O4NtZduGV+lPI/UG1FXtZQ6riKRybmTy17qya 1QSZ4cMwd0JaQ== To: Jim Porter From: Heime Subject: Re: bug#59286: Documentation for seq-count Message-ID: <4JV1rKTt-yUtH3mYvGuGtGDiCuWoVlTNakIzeJ1KcNeAJH3NbISV8VqQw0YDOLfmR1dCU54bdX3Tg9_YGx6kfpI34c5gtJ6SJI8bu-Bwhm4=@protonmail.com> In-Reply-To: <8a927541-93b8-1a44-43df-77251280ffbe@gmail.com> References: <8a927541-93b8-1a44-43df-77251280ffbe@gmail.com> Feedback-ID: 57735886:user:proton MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -0.0 (/) X-Debbugs-Envelope-To: 59286 Cc: 59286@debbugs.gnu.org, =?utf-8?Q?Rudolf_Adamkovi=C4=8D?= X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) ------- Original Message ------- On Wednesday, November 16th, 2022 at 6:09 PM, Jim Porter wrote: > On 11/16/2022 9:59 AM, Heime via Bug reports for GNU Emacs, the Swiss > army knife of text editors wrote: >=20 > > Fine, but how do you use that? No information, no example. Seems to me = that > > authors of documentation willfully avoid showing examples or where to f= ind them. >=20 >=20 > In a Help buffer, just below the docstring is this message: >=20 > Other relevant functions are documented in the sequence group. >=20 > Clicking on "sequence" takes you to shortdocs, which shows an example: >=20 > =EF=BB=BF (seq-count #'numberp '(1 b c 4)) > =E2=87=92 2 >=20 > Maybe the "Other relevant functions" wording could be improved so that > it's clearer though. It doesn't really indicate that you'll find more > details about 'seq-count' in particular, just "other relevant > functions". Something like, "See the sequence group for more > information on this and other relevant functions," maybe? It also says "Undocumented" at the end. Documentation is not as helpful as many people think they are. From debbugs-submit-bounces@debbugs.gnu.org Wed Nov 16 14:40:31 2022 Received: (at 59286) by debbugs.gnu.org; 16 Nov 2022 19:40:31 +0000 Received: from localhost ([127.0.0.1]:58235 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovOGs-0008Dl-Ny for submit@debbugs.gnu.org; Wed, 16 Nov 2022 14:40:30 -0500 Received: from eggs.gnu.org ([209.51.188.92]:42570) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovOGo-0008DW-OM for 59286@debbugs.gnu.org; Wed, 16 Nov 2022 14:40:28 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ovOGj-0005o8-66; Wed, 16 Nov 2022 14:40:21 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=/tR8RARaOs3u5iCMcSgIY7GbL+kfUtolZzY/oJ3GtDo=; b=PY9ZbamrVXsH ffSDi9o43IfqL/1c56tcqPjbk7XgZZ+clZDZTC08StBu8gI9VgETvyFi5jQQl5VS4USwousJA1zDL rqHeywpzZW2Pc6IDxveDyJ+0p6eBe0eRdzWyMGXBSh7UiNwZ9WIrdR7wD2NQ0/Y+dFkZNazXjf2X0 aylPJb0snQxKCsjeNGZpVJK4jWQLNfNJNoBJlUD2hdUeOKTI5s1T4gn12RlCstJ/FxkSO1oKUAnkZ ZaeJ1SNd8cjzRMSPum/3Mn3WZSh59bJh697cJxiSC0GyXcE+duD3kAUZdDNrvz52B3pMEtnuVOdyn GQJ+vL+oPU461wJo8kwr8Q==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ovOGi-0004NM-MV; Wed, 16 Nov 2022 14:40:21 -0500 Date: Wed, 16 Nov 2022 21:40:19 +0200 Message-Id: <83bkp6g02k.fsf@gnu.org> From: Eli Zaretskii To: Heime In-Reply-To: (bug-gnu-emacs@gnu.org) Subject: Re: bug#59286: Documentation for seq-count References: X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 59286 Cc: 59286@debbugs.gnu.org, salutis@me.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Cc: 59286@debbugs.gnu.org > Date: Wed, 16 Nov 2022 17:59:44 +0000 > From: Heime via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" > > > It helps to know that "PRED" stands for the English word PREDICATE. > > Fine, but how do you use that? No information, no example. Seems to me that > authors of documentation willfully avoid showing examples or where to find them. Where did you look for examples? There's an example in the ELisp manual. From debbugs-submit-bounces@debbugs.gnu.org Wed Nov 16 14:52:00 2022 Received: (at 59286) by debbugs.gnu.org; 16 Nov 2022 19:52:00 +0000 Received: from localhost ([127.0.0.1]:58258 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovORz-00007b-VR for submit@debbugs.gnu.org; Wed, 16 Nov 2022 14:52:00 -0500 Received: from eggs.gnu.org ([209.51.188.92]:33838) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ovORu-00007J-Nr for 59286@debbugs.gnu.org; Wed, 16 Nov 2022 14:51:58 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ovORp-0008P8-5m; Wed, 16 Nov 2022 14:51:49 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From: Date; bh=L+Y7cQ26Py6U8MWHlt+cXiAV1RL0AP7qW0W+VqTYmlU=; b=ST8APN3XMOtsnhGJW2Qa /8xcZXeq/ijbWJtbQ6bSGzFuyDfSB4iB/W/Nvl6Jc7T2JLXB0mr2Y8YM5M4h7lnBAnjCATN7BdGMt DcUQE6P15p7fR7fbcl7I7OWQW/XPQjcVrv+LwmZ1dEYnGmclmq3SEjYLZK+0X3dsf7lPBghcCyJV1 DBP684DBxrViQccW+/7VjTGngcpHPXj9MDhSLF8t6bp66sXskyM6rsR1APYMzpxir8+Cw/8r4onwP CTrILJm8ns8iddtmKB5afgQaAQuKqaA/W3trHfxPxc+xKatZD6e8AV5E4GWX3IXgYAqH6U28QSacY Y99WvnHEMdaaBQ==; Received: from [87.69.77.57] (helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ovORo-0005gx-HX; Wed, 16 Nov 2022 14:51:48 -0500 Date: Wed, 16 Nov 2022 21:51:48 +0200 Message-Id: <837czufzjf.fsf@gnu.org> From: Eli Zaretskii To: Heime In-Reply-To: <4JV1rKTt-yUtH3mYvGuGtGDiCuWoVlTNakIzeJ1KcNeAJH3NbISV8VqQw0YDOLfmR1dCU54bdX3Tg9_YGx6kfpI34c5gtJ6SJI8bu-Bwhm4=@protonmail.com> (bug-gnu-emacs@gnu.org) Subject: Re: bug#59286: Documentation for seq-count References: <8a927541-93b8-1a44-43df-77251280ffbe@gmail.com> <4JV1rKTt-yUtH3mYvGuGtGDiCuWoVlTNakIzeJ1KcNeAJH3NbISV8VqQw0YDOLfmR1dCU54bdX3Tg9_YGx6kfpI34c5gtJ6SJI8bu-Bwhm4=@protonmail.com> MIME-version: 1.0 Content-type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 59286 Cc: jporterbugs@gmail.com, salutis@me.com, 59286@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > Cc: 59286@debbugs.gnu.org, Rudolf Adamkovič > Date: Wed, 16 Nov 2022 18:50:41 +0000 > From: Heime via "Bug reports for GNU Emacs, > the Swiss army knife of text editors" > > It also says "Undocumented" at the end. You misunderstood what that means in this case. From debbugs-submit-bounces@debbugs.gnu.org Sun Sep 10 15:32:12 2023 Received: (at 59286-done) by debbugs.gnu.org; 10 Sep 2023 19:32:12 +0000 Received: from localhost ([127.0.0.1]:51372 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qfQAG-00079P-5j for submit@debbugs.gnu.org; Sun, 10 Sep 2023 15:32:12 -0400 Received: from mail-lj1-x229.google.com ([2a00:1450:4864:20::229]:59746) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1qfQAB-00079A-VQ for 59286-done@debbugs.gnu.org; Sun, 10 Sep 2023 15:32:10 -0400 Received: by mail-lj1-x229.google.com with SMTP id 38308e7fff4ca-2bcd7a207f7so59242321fa.3 for <59286-done@debbugs.gnu.org>; Sun, 10 Sep 2023 12:32:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1694374318; x=1694979118; darn=debbugs.gnu.org; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:from:to:cc:subject:date:message-id:reply-to; bh=L9k5ue+RBPcfW/eQ7M7+lm79CIOXpAfVDVgn6ILztjU=; b=qeo5yFo9TW6sHYZeq/BPk0fQyioBhmBVPEYp//ExulJsJcgrgjczKD5CTiogq3BiH+ YITfrXAxk62i2BKDB9GS6LBfp+UIB0BG5jd47ZE5pymsx/wN0ZHk433exKuZ9S34DML4 XFTQybUDphqa9/cr4Wnj1g5+EWCgjN9DJweYqpz/guhdwidZN1VWr8V33FjjUnq4mjuI nItJYyt7p8C8z7N2XlqXwykAG+7TKDSpwMF2kb7oJsE+3XG6IsioCUSQRnK0UqiQ2uIL eF2GACMWm21ZWuouH6boieMAb2Xifdmr25/e6Ml4cFe21wiTRvUQtTjhplEOS9W9Pa8R 3cTg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1694374318; x=1694979118; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=L9k5ue+RBPcfW/eQ7M7+lm79CIOXpAfVDVgn6ILztjU=; b=Ho5Fg2B+2S4gX+nATSQ3EpGzbWNN+Yjq482gzSltyQBqrwY4fGYWfaYY1C8EpofwAm QPaYUL93Nzu+5fcREJ/E7ewIkpxT+eeV+ecRQdE/9uweVZMdNv6FeDwV71jsRJlMObyE wc9J15riT1NP/QsyIL1Q/f2+DcucKvPt1YwqhHkz2/xAFJHKAq6tgnra/sRlZuC0nKQM WqW9KOm2updtYIRsjSmqJq9So8rqBAXJAY4X/B8AqsSqdoC/y2p82Kd0vS6lK6kg1n26 aCmh+qu7bwMPMESBGgx0Ftlu8aGmy6MNoI+kgrbl9Fr/Ay2KiA0J6kSIhKBVyInKcnh1 9K0w== X-Gm-Message-State: AOJu0YxWhjuSiz+Zv9nrk4Ia7N2H/KOa+HmOHY+guRaPLmiuCjgnx61q EEE8HBE9lTUsofFq5OgsQSe6U50zRRfklOvO9m8= X-Google-Smtp-Source: AGHT+IGLm++YSZigf51Tac3mhkyEncsneNRDzWrGfaHd+sNutv6BVQSCEtm6kx41hswlxgwt0qpbsEbEq/4YdQTr8Zc= X-Received: by 2002:a2e:9d0c:0:b0:2b8:39e4:2e2c with SMTP id t12-20020a2e9d0c000000b002b839e42e2cmr6221887lji.1.1694374318224; Sun, 10 Sep 2023 12:31:58 -0700 (PDT) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sun, 10 Sep 2023 12:31:57 -0700 From: Stefan Kangas In-Reply-To: (Heime's message of "Tue, 15 Nov 2022 16:18:46 +0000") References: MIME-Version: 1.0 Date: Sun, 10 Sep 2023 12:31:57 -0700 Message-ID: Subject: Re: bug#59286: Documentation for seq-count To: Heime Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: 59286-done Cc: 59286-done@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Heime writes: > Have scrutinised the documentation for "seq-count". A description that is quite undecipherable. > > (seq-count PRED SEQUENCE) > Return the number of elements for which (PRED element) is non-nil in SEQUENCE. This now reads: Return the number of elements in SEQUENCE for which PRED returns non-nil. This seems more readable to me, so I'm closing this bug. From unknown Mon Aug 18 19:35:31 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Mon, 09 Oct 2023 11:24:11 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator