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 17:11:32 +0100 Message-ID: <87y2i7x8ln.fsf@web.de> References: <87ft4f3xll.fsf@gnus.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="7685"; 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 17:12:13 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 1kn24b-0001sB-6Q for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 09 Dec 2020 17:12:13 +0100 Original-Received: from localhost ([::1]:45842 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kn24a-0004lf-68 for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 09 Dec 2020 11:12:12 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51160) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kn24Q-0004kY-Oq for bug-gnu-emacs@gnu.org; Wed, 09 Dec 2020 11:12:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]:52512) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kn24Q-0008M8-CA for bug-gnu-emacs@gnu.org; Wed, 09 Dec 2020 11:12:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kn24Q-0003UJ-6o for bug-gnu-emacs@gnu.org; Wed, 09 Dec 2020 11:12:02 -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 16:12:02 +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.160753030713388 (code B ref 42323); Wed, 09 Dec 2020 16:12:02 +0000 Original-Received: (at 42323) by debbugs.gnu.org; 9 Dec 2020 16:11:47 +0000 Original-Received: from localhost ([127.0.0.1]:35825 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kn24B-0003Ts-Gq for submit@debbugs.gnu.org; Wed, 09 Dec 2020 11:11:47 -0500 Original-Received: from mout.web.de ([212.227.15.14]:35089) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kn249-0003Tg-Kf for 42323@debbugs.gnu.org; Wed, 09 Dec 2020 11:11:46 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1607530294; bh=wR45HkUNscHTZVSD15qCRCDlHhJDLKRScrS4aZ9Hm3A=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=V11lwgctynCfDChibY3S/pvsr+IdAfd0a9oAx373GrmN/80pkzD7TLJGwwGCOSyDp 5GHXLcuUWTJfOp4oE+M7aNPgiz+l27ayrO02PDXSoN7a3BcieDUfNYCUXG4hkOtUyd H8dy3phUFAw/vk2NIip/Ouf9EywzKcAEvGUvtlZk= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Original-Received: from drachen.dragon ([88.67.99.46]) by smtp.web.de (mrweb005 [213.165.67.108]) with ESMTPSA (Nemesis) id 1MCGSU-1kwLSB3NOE-009fVC; Wed, 09 Dec 2020 17:11:33 +0100 In-Reply-To: <87ft4f3xll.fsf@gnus.org> (Lars Ingebrigtsen's message of "Wed, 09 Dec 2020 14:41:58 +0100") X-Provags-ID: V03:K1:D1NTYsjR/2WJha3pdyA7wPMxPgrzDVFYAvR0/rArbDHkuNgjoo7 henYX7NSfD8GwzGj5J8OA3Lv6gk5nW0Uq4e/NRJebOnqDDmDDJogJvF7LdGSGQlKZEK/rtL 8/TfLkmWWwe5KTSs5+hw6p2z4jPnNhdNVaQQAtLSmjMo3tfO93YRod9F9MoYoZB5kReg07V cFagbVW63x6AkAjAywfdA== X-UI-Out-Filterresults: notjunk:1;V03:K0:EKZ6zE4vjd8=:/I0CauklQIhorDu390baHQ uhMqy7OKHVnauM/VSzLHJNcg9naoivnsJb3k7I76QrPcuqLq14Ff7t/Ia5HOL5AnJCiw5eSIU GGFlXuN3F5ltoV1o1oHE6fX8BuEe5lBRtb+UUEiFvZXmybSnrLTLSozl8YTLk5OoHUQNncFCI Sb64/WRNSXbN3Myu6Eapqq3eV+N5XhdEEHU5ryfBp5AngCShziJPRV1Jcn0YOwsePbWNZiQBr nRoW1d4aNZl2cOTossu8BkJ3KrALDAP4D1MO60dfy3AAG+mXxHQSO3PDNmyWI9avoWuROjfk/ 9vPACfbpKXEDM9sYkvqeva0GXKAxTNBuSUR6mIPBO0LNYv8+/jGOT8Mq7wnSGCPg17VkfnMAJ 9ApX4UMTQhDpisXz5eSbvb7PWEUzXdzM1MsPmegXUV63txQntne1LITzIdlcc8EWoC47swrVV 9dhS2TNVn26DFgNmLju8uuKnODvCIpowa3G6LPrewC909IXWAbnPp7O1U4Umymp9MbikGArl7 eNeaUkaj1v+TUN6+LLiEhbKSoDzyg295DxHhMk9cKx/aAzeBQZVSUBf5K16oF49NEBsglfpLy q6gvgwu7is6fZpQbwFIsF8x89Y/Nzvb4MKOtowYv42c/6330nFp/ghx4SRnisq8j6g2pLR/D9 0vQeQQefGcLm+gSL8B7krKV4Ooi7glMvkt8EB+k7VQSGaCqkP0MirC8XQredhGswImzfv590t kX8P95DKzVI5D12pMeylHRb+aLlZ7feo1dCGa+gNw8RbyxP4N+jeGX8qWP4HuieMsp9DoavK 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:195539 Archived-At: Lars Ingebrigtsen writes: > It is, indeed, pretty obscure. Like Drew, I wonder -- do we really > have to put these implementation details in the doc string at all? > Opinions? [ Such things were often knitted with hot needle by Stefan, left for us as "an exercise", to formulate positive ] Details: yes, it's good to have a list of implementations. Obscure: No. The generated doc of implementations is indeed rather obscure. Needs a good heart to fix: > Implementations: > > #'(sequence sequence) in =E2=80=98seq.el=E2=80=99. ^^^^^^^^^^^^^^^^^^^^^ What syntax is that actually? An accident? > Undocumented I would remove "Undocumented", it makes the text rather unreadable when repeated often. > #'sequence in =E2=80=98seq.el=E2=80=99. > > Undocumented I wonder to what that is actually referring to. There is only one implementation in seq.el...? Regards, Michael.