From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#42324: 26.3; Doc string of `seq-concatenate' Date: Wed, 26 Aug 2020 21:57:50 +0300 Message-ID: <83imd52q1d.fsf@gnu.org> References: <<>> <<>> <<>> <<<83a6yi3q0p.fsf@gnu.org>>> <> <<83mu2h2rah.fsf@gnu.org>> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="20604"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 42324@debbugs.gnu.org, stefan@marxist.se To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Aug 26 20:59:09 2020 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 1kB0dY-0005Dd-O8 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 26 Aug 2020 20:59:08 +0200 Original-Received: from localhost ([::1]:35162 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kB0dX-0002f8-Qw for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 26 Aug 2020 14:59:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:34572) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kB0dS-0002ey-Ef for bug-gnu-emacs@gnu.org; Wed, 26 Aug 2020 14:59:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:57530) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kB0dS-00039m-69 for bug-gnu-emacs@gnu.org; Wed, 26 Aug 2020 14:59:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kB0dS-0002jA-5j for bug-gnu-emacs@gnu.org; Wed, 26 Aug 2020 14:59:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 26 Aug 2020 18:59:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 42324 X-GNU-PR-Package: emacs Original-Received: via spool by 42324-submit@debbugs.gnu.org id=B42324.159846829310429 (code B ref 42324); Wed, 26 Aug 2020 18:59:02 +0000 Original-Received: (at 42324) by debbugs.gnu.org; 26 Aug 2020 18:58:13 +0000 Original-Received: from localhost ([127.0.0.1]:40843 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kB0ce-0002i9-Nx for submit@debbugs.gnu.org; Wed, 26 Aug 2020 14:58:12 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:52482) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kB0cc-0002hw-Kd for 42324@debbugs.gnu.org; Wed, 26 Aug 2020 14:58:11 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:38167) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kB0cW-000356-RL; Wed, 26 Aug 2020 14:58:04 -0400 Original-Received: from [176.228.60.248] (port=4470 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kB0cV-00016m-SG; Wed, 26 Aug 2020 14:58:04 -0400 In-Reply-To: (message from Drew Adams on Wed, 26 Aug 2020 11:37:39 -0700 (PDT)) 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" Xref: news.gmane.io gmane.emacs.bugs:186469 Archived-At: > Date: Wed, 26 Aug 2020 11:37:39 -0700 (PDT) > From: Drew Adams > Cc: stefan@marxist.se, 42324@debbugs.gnu.org > > > The doc string seems clear to me. And since I don't understand what > > are #1, #2, and #3 in your notation, I cannot continue this discussion > > in any useful way, sorry. > > >From the bug report (and elsewhere in the thread I > also made clear what #1, #2, and #3 referred to): > > 1. See bug #42323 for the problem of the unhelpful, > implicit reference to CL implementations and > "generic function". There's no reference to CL in the current doc string. > 2. The doc of `seq-concatenate' _really_ needs a > description of how it differs from `cl-concatenate'. > That's completely unclear. There's no reference to cl-concatenate in the current doc string. > 3. The doc says nothing about each SEQUENCE actually > being automatically converted (by copying, presumably) > into a real sequence: `seq-into-sequence'. Why should it mention something like that? > It's > not clear what's allowed as SEQUENCE. Any sequence, obviously. Anyway, the current doc string spells it out: TYPE must be one of following symbols: vector, string or list. > #2 is the main reason I filed this bug report. What's the difference? > Why/when would you use one rather than the other? I guess that problem no longer exists with the current doc string.