From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#32125: 26; Doc of `seqp` versus `sequencep` Date: Sat, 14 Jul 2018 11:18:49 +0300 Message-ID: <83k1pyb57a.fsf@gnu.org> References: NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: blaine.gmane.org 1531556223 3601 195.159.176.226 (14 Jul 2018 08:17:03 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 14 Jul 2018 08:17:03 +0000 (UTC) Cc: 32125@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jul 14 10:16:59 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1feFje-0000ol-Up for geb-bug-gnu-emacs@m.gmane.org; Sat, 14 Jul 2018 10:16:59 +0200 Original-Received: from localhost ([::1]:40501 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1feFll-0005wp-RB for geb-bug-gnu-emacs@m.gmane.org; Sat, 14 Jul 2018 04:19:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:53230) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1feFlf-0005wj-7A for bug-gnu-emacs@gnu.org; Sat, 14 Jul 2018 04:19:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1feFle-0004Mf-8f for bug-gnu-emacs@gnu.org; Sat, 14 Jul 2018 04:19:03 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:51588) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1feFle-0004MY-42 for bug-gnu-emacs@gnu.org; Sat, 14 Jul 2018 04:19:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1feFld-000614-SZ for bug-gnu-emacs@gnu.org; Sat, 14 Jul 2018 04:19:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 14 Jul 2018 08:19:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 32125 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 32125-submit@debbugs.gnu.org id=B32125.153155633623115 (code B ref 32125); Sat, 14 Jul 2018 08:19:01 +0000 Original-Received: (at 32125) by debbugs.gnu.org; 14 Jul 2018 08:18:56 +0000 Original-Received: from localhost ([127.0.0.1]:59485 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1feFlY-00060l-97 for submit@debbugs.gnu.org; Sat, 14 Jul 2018 04:18:56 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:33984) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1feFlX-00060Y-1b for 32125@debbugs.gnu.org; Sat, 14 Jul 2018 04:18:55 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1feFlO-0004HV-Q2 for 32125@debbugs.gnu.org; Sat, 14 Jul 2018 04:18:49 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:40210) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1feFlO-0004HP-M2; Sat, 14 Jul 2018 04:18:46 -0400 Original-Received: from [176.228.60.248] (port=2890 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1feFlO-0001he-2l; Sat, 14 Jul 2018 04:18:46 -0400 In-reply-to: (message from Drew Adams on Wed, 11 Jul 2018 06:50:44 -0700 (PDT)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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: 208.118.235.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:148518 Archived-At: > 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-‘nil’ if OBJECT is a sequence (a list or array), or any additional type of sequence defined via ‘seq.el’ ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 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. Thanks.