From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#42324: 26.3; Doc string of `seq-concatenate' Date: Wed, 26 Aug 2020 11:37:39 -0700 (PDT) Message-ID: References: <<>> <<>> <<>> <<<83a6yi3q0p.fsf@gnu.org>>> <> <<83mu2h2rah.fsf@gnu.org>> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="8176"; mail-complaints-to="usenet@ciao.gmane.io" Cc: 42324@debbugs.gnu.org, stefan@marxist.se To: Eli Zaretskii , Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Aug 26 20:38: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 1kB0JE-00020S-Bz for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 26 Aug 2020 20:38:08 +0200 Original-Received: from localhost ([::1]:60498 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kB0JD-0005le-Eu for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 26 Aug 2020 14:38:07 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:58000) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kB0J8-0005lX-2y for bug-gnu-emacs@gnu.org; Wed, 26 Aug 2020 14:38:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:57493) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kB0J7-0000Re-Q3 for bug-gnu-emacs@gnu.org; Wed, 26 Aug 2020 14:38:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kB0J7-0002BD-Ma for bug-gnu-emacs@gnu.org; Wed, 26 Aug 2020 14:38:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 26 Aug 2020 18:38:01 +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.15984670708351 (code B ref 42324); Wed, 26 Aug 2020 18:38:01 +0000 Original-Received: (at 42324) by debbugs.gnu.org; 26 Aug 2020 18:37:50 +0000 Original-Received: from localhost ([127.0.0.1]:40806 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kB0Iv-0002Ad-Uj for submit@debbugs.gnu.org; Wed, 26 Aug 2020 14:37:50 -0400 Original-Received: from userp2120.oracle.com ([156.151.31.85]:35796) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kB0It-0002AP-UA for 42324@debbugs.gnu.org; Wed, 26 Aug 2020 14:37:48 -0400 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 07QIZRAP191970; Wed, 26 Aug 2020 18:37:42 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2020-01-29; bh=mmp+2blQrCPhOV5706uf8HePxV2MNcZ5ZNjPXIkCkSM=; b=qybvWE0BsY5vulNeSTKJdNxm/qqVyJcp1Rqszm19L6GAv/JhPtRjtLak/WIJPm6acRzH iR1QuQ8z8u5vs3OQcaMTgJzIOxpDQy3aO8QcnUSsG8awN++TMzRlmy16DHU2ZQIY+D/U 6Loh/Zjpv0rRGidCINusVk07KatYrR8AJV8NYQ1n8GUxXWTra/zAOnjCkICP0/WRSV3t qtk3GUhuy4qdrgW5yCJI5lD5XJIN9YUAq19chDGUqYu2K68zAMuZZlQeiFIxS/824sd7 8KVKQWqPc/nnz2iIG6AM/gZbN+CgUyogdXpWL7aaFkulpgri1CqdYNWTsbH0em/b3gSP zw== Original-Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by userp2120.oracle.com with ESMTP id 333w6u0qh6-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=FAIL); Wed, 26 Aug 2020 18:37:41 +0000 Original-Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 07QIZMmW073994; Wed, 26 Aug 2020 18:37:41 GMT Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by userp3030.oracle.com with ESMTP id 333r9m9jxa-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Wed, 26 Aug 2020 18:37:41 +0000 Original-Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id 07QIbe56022010; Wed, 26 Aug 2020 18:37:40 GMT In-Reply-To: <<83mu2h2rah.fsf@gnu.org>> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.5044.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9725 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 phishscore=0 suspectscore=0 malwarescore=0 spamscore=0 mlxlogscore=999 mlxscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2008260137 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9725 signatures=668679 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 adultscore=0 impostorscore=0 mlxlogscore=999 suspectscore=0 phishscore=0 malwarescore=0 spamscore=0 priorityscore=1501 clxscore=1015 mlxscore=0 lowpriorityscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2006250000 definitions=main-2008260137 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:186465 Archived-At: > > The bug report is not about the implementation at > > all. It's about the doc specifying the behavior. >=20 > 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". 2. The doc of `seq-concatenate' _really_ needs a description of how it differs from `cl-concatenate'. That's completely unclear. 3. The doc says nothing about each SEQUENCE actually being automatically converted (by copying, presumably) into a real sequence: `seq-into-sequence'. It's not clear what's allowed as SEQUENCE. #2 is the main reason I filed this bug report. What's the difference? Why/when would you use one rather than the other?