From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#32125: 26; Doc of `seqp` versus `sequencep` Date: Sat, 28 Sep 2019 19:34:38 +0200 Message-ID: References: Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="111792"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 32125-done@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Sep 28 19:35:11 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iEGch-000SyU-C7 for geb-bug-gnu-emacs@m.gmane.org; Sat, 28 Sep 2019 19:35:11 +0200 Original-Received: from localhost ([::1]:34056 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iEGcg-0007Y3-6l for geb-bug-gnu-emacs@m.gmane.org; Sat, 28 Sep 2019 13:35:10 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:38164) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iEGcZ-0007Xc-C6 for bug-gnu-emacs@gnu.org; Sat, 28 Sep 2019 13:35:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iEGcY-0004ha-Ab for bug-gnu-emacs@gnu.org; Sat, 28 Sep 2019 13:35:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:42306) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1iEGcY-0004h5-6x for bug-gnu-emacs@gnu.org; Sat, 28 Sep 2019 13:35:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1iEGcY-00050D-3d for bug-gnu-emacs@gnu.org; Sat, 28 Sep 2019 13:35:02 -0400 In-Reply-To: Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Sat, 28 Sep 2019 17:35:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 32125 X-GNU-PR-Package: emacs Mail-Followup-To: 32125@debbugs.gnu.org, stefan@marxist.se, drew.adams@oracle.com Original-Received: via spool by 32125-done@debbugs.gnu.org id=D32125.156969209719212 (code D ref 32125); Sat, 28 Sep 2019 17:35:01 +0000 Original-Received: (at 32125-done) by debbugs.gnu.org; 28 Sep 2019 17:34:57 +0000 Original-Received: from localhost ([127.0.0.1]:51127 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iEGcT-0004zn-36 for submit@debbugs.gnu.org; Sat, 28 Sep 2019 13:34:57 -0400 Original-Received: from mail-pl1-f182.google.com ([209.85.214.182]:45310) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iEGcR-0004za-CA for 32125-done@debbugs.gnu.org; Sat, 28 Sep 2019 13:34:55 -0400 Original-Received: by mail-pl1-f182.google.com with SMTP id u12so2273714pls.12 for <32125-done@debbugs.gnu.org>; Sat, 28 Sep 2019 10:34:55 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:from:date:message-id:subject:to:cc :content-transfer-encoding; bh=6iDTW4luoGTEGT1vFBywl/UutI2KwuIN5cz0UxqBQWk=; b=tTNNiMoY7B5ly61NycIV3EChE4xTZTSs0mUZGKlOrsAY75oErrAJZUwFBxzM0tkBZr 2zDPvp9PnUIxNZ64N39bcggkcEpjzoLsT7S6SAoxGE1Nb1eHuKn/oKQM/qotIQK6+ro8 QsKFF1rQNqSgZTVPxO6ACIagISzGgXG66x0/vnpRSNlxSK3s01M6+7HAkDTDO+EgPzIy HViKkE6fR85T6bkbcLAp65A1iCBcDir1JXaLI+E3Citl2FjtaYWEqo1iLWD4QTiJx8bI StSPlI3Z3aH0lb+dbXZqPvvPuaCy1UAVHzZsABEI2bgUq+1oPP1FDQzMasL2oZgp7xch T6sA== X-Gm-Message-State: APjAAAVSD0i6kpsouYwX6fek8TRzJHjxa6ShjvGbeqg7RYcv0I+qdOuK W398UnoWvLzbsDxuL61LlbE49L/azHREQwRgj2o= X-Google-Smtp-Source: APXvYqw/f3VyPqpIZTgtA1lYn2VPBLGSTELr58AEH1nMAJe37GNhvGc+7Z6HigiSBVFG6tLN0W7ePZqGCXzy3rt5ZmU= X-Received: by 2002:a17:902:a515:: with SMTP id s21mr11878805plq.259.1569692089589; Sat, 28 Sep 2019 10:34:49 -0700 (PDT) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:167501 Archived-At: Eli Zaretskii writes: >> Date: Wed, 11 Jul 2018 06:50:44 -0700 (PDT) >> From: Drew Adams >> >> Neither the doc strings nor the descriptions in (elisp) `Sequence >> Functions' make clear what the difference is between these predicates. > > I think it does: > > This function returns non-=E2=80=98nil=E2=80=99 if OBJECT is a seque= nce (a list or > array), or any additional type of sequence defined via =E2=80=98seq.= el=E2=80=99 > ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ > generic functions. > ^^^^^^^^^^^^^^^^^ > >> (It's not even clear why `seq' was added. What's that about?) > > See above. At least on the level your question was asked, the answer > is clearly there. > >> And the name `seqp' seems like a bad choice. the predicate names >> themselves should at least give some hint of the difference. > > Is this a separate bug? Is it really important? > >> The doc for `seqp' should not just punt and tell users to go look in >> `seq.el' to figure out what it means: "or any additional type of >> sequence defined via 'seq.el' generic functions." > > What would you suggest as a better wording? The difficulty here is > that seq.el provides features that are inherently extensible, so I > don't think an exhaustive list can be given. But I might be wrong. > >> And in (elisp) `Sequence Functions' the entries for these two predicates >> should be right next to each other. > > I don't see a compelling reason to have them adjacent, but I did add > some text in the description of each one of them to mention the other > one. Last update here was one year ago, and I can't see that there is anything else to do here after Eli's fixes. I'm therefore closing this bug. If anyone disagrees, feel free to re-open. Best regards, Stefan Kangas