From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Jim Porter Newsgroups: gmane.emacs.bugs Subject: bug#59286: Documentation for seq-count Date: Wed, 16 Nov 2022 10:09:39 -0800 Message-ID: <8a927541-93b8-1a44-43df-77251280ffbe@gmail.com> References: Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="19466"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 59286@debbugs.gnu.org To: Heime , Rudolf =?UTF-8?Q?Adamkovi=C4=8D?= Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Nov 16 19:10:13 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 1ovMrU-0004uC-Hr for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 16 Nov 2022 19:10:12 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ovMrM-0000zy-Bm; Wed, 16 Nov 2022 13:10: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 1ovMrK-0000zO-0y for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2022 13:10: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 1ovMrJ-0006wg-NT for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2022 13:10:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ovMrJ-0001R7-K9 for bug-gnu-emacs@gnu.org; Wed, 16 Nov 2022 13:10:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Jim Porter Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 16 Nov 2022 18:10:01 +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.16686221935503 (code B ref 59286); Wed, 16 Nov 2022 18:10:01 +0000 Original-Received: (at 59286) by debbugs.gnu.org; 16 Nov 2022 18:09:53 +0000 Original-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 Original-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 Original-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) Original-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) Content-Language: en-US In-Reply-To: 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:248034 Archived-At: 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?