From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Heime 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:50:41 +0000 Message-ID: <4JV1rKTt-yUtH3mYvGuGtGDiCuWoVlTNakIzeJ1KcNeAJH3NbISV8VqQw0YDOLfmR1dCU54bdX3Tg9_YGx6kfpI34c5gtJ6SJI8bu-Bwhm4=@protonmail.com> References: <8a927541-93b8-1a44-43df-77251280ffbe@gmail.com> Reply-To: Heime 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="10726"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 59286@debbugs.gnu.org, Rudolf =?UTF-8?Q?Adamkovi=C4=8D?= To: Jim Porter Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Nov 16 19:52:23 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 1ovNWJ-0002WQ-12 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 16 Nov 2022 19:52:23 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ovNW0-0001SJ-PA; Wed, 16 Nov 2022 13:52: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 1ovNVy-0001Rw-Vn for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2022 13:52: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 1ovNVy-00027Z-Nh for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2022 13:52:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ovNVy-0004ht-CB for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2022 13:52:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Heime Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 16 Nov 2022 18:52: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.166862466318021 (code B ref 59286); Wed, 16 Nov 2022 18:52:02 +0000 Original-Received: (at 59286) by debbugs.gnu.org; 16 Nov 2022 18:51:03 +0000 Original-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 Original-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 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== In-Reply-To: <8a927541-93b8-1a44-43df-77251280ffbe@gmail.com> Feedback-ID: 57735886:user:proton 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:248035 Archived-At: ------- 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.