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 09:00:38 +0300 Message-ID: <83a6yi3q0p.fsf@gnu.org> References: Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="30082"; 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 08:04:39 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 1kAoY2-0007iH-Oi for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 26 Aug 2020 08:04:38 +0200 Original-Received: from localhost ([::1]:36172 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kAoY1-00064k-Ny for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 26 Aug 2020 02:04:37 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:32856) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kAoVY-0003gK-Tr for bug-gnu-emacs@gnu.org; Wed, 26 Aug 2020 02:02:05 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:53830) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kAoVW-0006WC-EP for bug-gnu-emacs@gnu.org; Wed, 26 Aug 2020 02:02:04 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kAoVW-0005iB-Bk for bug-gnu-emacs@gnu.org; Wed, 26 Aug 2020 02:02: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 06:02: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.159842167021885 (code B ref 42324); Wed, 26 Aug 2020 06:02:02 +0000 Original-Received: (at 42324) by debbugs.gnu.org; 26 Aug 2020 06:01:10 +0000 Original-Received: from localhost ([127.0.0.1]:37143 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kAoUg-0005gv-0F for submit@debbugs.gnu.org; Wed, 26 Aug 2020 02:01:10 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:50798) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kAoUe-0005gg-0W for 42324@debbugs.gnu.org; Wed, 26 Aug 2020 02:01:08 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:54768) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kAoUX-0006Ry-Sx; Wed, 26 Aug 2020 02:01:02 -0400 Original-Received: from [176.228.60.248] (port=3408 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1kAoUS-0000US-BE; Wed, 26 Aug 2020 02:01:00 -0400 In-Reply-To: (message from Drew Adams on Tue, 25 Aug 2020 15:46:59 -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:186395 Archived-At: > Date: Tue, 25 Aug 2020 15:46:59 -0700 (PDT) > From: Drew Adams > Cc: 42324@debbugs.gnu.org > > In Emacs 26.3, this is the definition of `seq-concatenate': > > (cl-defgeneric seq-concatenate (type &rest sequences) > "Concatenate SEQUENCES into a single sequence of type TYPE. > TYPE must be one of following symbols: vector, string or list. > > \n(fn TYPE SEQUENCE...)" > (apply #'cl-concatenate > type > (seq-map #'seq-into-sequence sequences))) If the bug report is about the doc string, please don't show the implementation as your evidence. The issue is (or should be) with the text of the doc string. > I'd say, overall, that I don't understand the behavior > by reading the doc string. Which part(s) of the doc string's text are unclear? The text is short and IMO very clear, so I'm puzzled by this bug report to begin with. In general, it sounds like what you are after is to understand the implementation, and that can only be done by reading the code. In that case, I see no bug to report here.