From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#42323: 26.3; Doc string of `seq-map' Date: Wed, 09 Dec 2020 20:24:17 +0100 Message-ID: <87tusuye8u.fsf@web.de> References: <87ft4f3xll.fsf@gnus.org> <87y2i7x8ln.fsf@web.de> <87v9dbx724.fsf@gnus.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="7862"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: 42323@debbugs.gnu.org To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Dec 09 21:10:08 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 1kn5mp-0001rg-Il for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 09 Dec 2020 21:10:07 +0100 Original-Received: from localhost ([::1]:45026 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kn5mo-0000k6-BP for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 09 Dec 2020 15:10:06 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:39440) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kn55B-0001wt-VJ for bug-gnu-emacs@gnu.org; Wed, 09 Dec 2020 14:25:01 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52842) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kn55B-0006Ym-Ll for bug-gnu-emacs@gnu.org; Wed, 09 Dec 2020 14:25:01 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kn55B-0004Iq-IF for bug-gnu-emacs@gnu.org; Wed, 09 Dec 2020 14:25:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 09 Dec 2020 19:25:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 42323 X-GNU-PR-Package: emacs Original-Received: via spool by 42323-submit@debbugs.gnu.org id=B42323.160754187116499 (code B ref 42323); Wed, 09 Dec 2020 19:25:01 +0000 Original-Received: (at 42323) by debbugs.gnu.org; 9 Dec 2020 19:24:31 +0000 Original-Received: from localhost ([127.0.0.1]:36155 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kn54h-0004I3-5s for submit@debbugs.gnu.org; Wed, 09 Dec 2020 14:24:31 -0500 Original-Received: from mout.web.de ([212.227.17.11]:36935) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kn54e-0004Hp-S9 for 42323@debbugs.gnu.org; Wed, 09 Dec 2020 14:24:29 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1607541859; bh=nSCmD4OKOZnkLKCXyuUPPqO9m4/2zjQh2/qPrK4InsQ=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=eqhiWFCVo8TdtmcW6gt80Z8SvTXKfQQB7otn4ZFQvmCiBT18TEbbVSxlgBrSq3Qag poKN/s7im2tBEVospH3rVoLvs0oKTtCwCasdSc7p/2CJQSWoLQYAk1+dz2NP0Ap85s mEqh9ojagKoFyOvjPJldWuftN+7u6YW79/XPY8qA= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Original-Received: from drachen.dragon ([88.67.99.46]) by smtp.web.de (mrweb106 [213.165.67.124]) with ESMTPSA (Nemesis) id 1Mvslx-1jxrfB3IAh-00syMk; Wed, 09 Dec 2020 20:24:18 +0100 In-Reply-To: <87v9dbx724.fsf@gnus.org> (Lars Ingebrigtsen's message of "Wed, 09 Dec 2020 17:44:51 +0100") X-Provags-ID: V03:K1:4QCbnrkW0J+4o3qN1r5ws4yLwLUrDUlIaO1X9ZD9hZjyI1iKHMW zCmQaM3k8hXVegO5bXKK5mFUrUP/xBs4FQ82YPNtNax8YhhQb3gEyNwRzgccssLjt10EuNc WQKSeyYVZnlchQK4d/cNNx5oZnAGTOhYrvjldwuN05O4wjMJAn8ZV8ss6Uei6Bm7AcUYu8G 1YHUBIbJfzbkJ2ud2plMA== X-UI-Out-Filterresults: notjunk:1;V03:K0:5j/dE6laR3c=:2YFzoS7HIX00wFqK7mb8Cp B9Xn7bhlm/NYL8I2iBbwwmsVQcIt//LsTfB8PsZiT/qXwqS1H4XL3GfIzhN39k2itHzQLxTuZ HNGwA33vaiWcc30UQU7yhf/sb71ckC7nVYCTG9jm6xa3Mimpqhqt3X9qSirKnQuxbg4tHHxEu mSTswE/qmRiuvg71Y5woiHlOeTin76z9mivhUNnWoJgGr2UtiX3OtHgvjjICObbXLDC+0Ez21 /hLOdYtNpgQiX77qMDF060RLFrGhFEgMRe+wzVZo57sD0+nAI4fSShGZlB7VSseULzlCOr0O+ B4qQI+7A9A+pgAVV/wuF+HUJDS1pbiQ9oC9DD8UzpnjbRuBjoaNSwJrNJCVPpvwioj8GWMVgG gX1dnaBfXws/ZcifqUS/5kYivydHPYsb9qnY9srivQnSEgUU7bUzYR4qanOmyOBWdEZhYszf+ iiMjTisKLe8L0umnwOLntfJYcq0qDplMUU9/+Znbpkdpj80tnHzaOhS8mJLHHrLvYdde3LdvN PjmAeoRL74KCJUQtrsX3M+aWUNLxnn1v6HGv1VB1sfpZn/TvZTjB8kFopSkoDM9ZV7FN7hlSl CfSG8mwXiUYoV+DUU27v2REeDy/aXXNJZ3zE3TCHChe2EShOy5nrYk0M4pfQbBdMcX4TdFAm0 zO/tRVRFepbwUOCx6zQOHnKXMjtxohIbbR+jmkkkwkofxwMzM/JdfXjjcUhN2ngbXKL97EzmN 7zDMi8VhWC5PeRMXPQBQQKRsMGFXpwQQcZGltK1obwpLtORXPjr0dky2hBrnzMtZ3kFaehRD 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:195584 Archived-At: Lars Ingebrigtsen writes: > or whether that's achieved by defgeneric is immaterial to people using > seq-map: The interface to use remains identical. That's one side, yes. OTOH, the information might matter in some cases, e.g. when I want to know whether some interface is implemented for, say, streams, in this case. Or when the docstring mentions some special properties of an interface for a certain class of objects the user needs to know about. Maybe we can find a compromise, e.g. a list of all implementations, comma separated, not wasting much space, and then what we have now but only for those implementations that have a docstring. With the rule that an implementation should have a docstring if and only if the interface has some special property. Does that make sense? > > I wonder to what that is actually referring to. There is only one > > implementation in seq.el...? > > There's two: > > (cl-defgeneric seq-map (function sequence) > (cl-defmethod seq-map (function (sequence sequence)) Ah, I didn't notice that the first is the default (maybe that could be mentioned), and that the word "sequence" has two meanings here: one includes e.g. streams (that's were the default is used) and one is the classical sense that excludes streams and is faster than the default. Michael.