From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.bugs Subject: bug#42323: 26.3; Doc string of `seq-map' Date: Sat, 25 Sep 2021 08:25:09 -0700 Message-ID: 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="14757"; 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 Sat Sep 25 17:48:57 2021 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 1mU9v7-0003eY-Ca for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 25 Sep 2021 17:48:57 +0200 Original-Received: from localhost ([::1]:38430 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mU9v6-0006ji-Bu for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 25 Sep 2021 11:48:56 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46846) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mU9Yw-0003F3-JO for bug-gnu-emacs@gnu.org; Sat, 25 Sep 2021 11:26:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:51050) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1mU9Yv-0007N0-RG for bug-gnu-emacs@gnu.org; Sat, 25 Sep 2021 11:26:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1mU9Yv-0003g9-NX for bug-gnu-emacs@gnu.org; Sat, 25 Sep 2021 11:26:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Kangas Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 Sep 2021 15:26: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.163258351714016 (code B ref 42323); Sat, 25 Sep 2021 15:26:01 +0000 Original-Received: (at 42323) by debbugs.gnu.org; 25 Sep 2021 15:25:17 +0000 Original-Received: from localhost ([127.0.0.1]:34348 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mU9YD-0003e0-24 for submit@debbugs.gnu.org; Sat, 25 Sep 2021 11:25:17 -0400 Original-Received: from mail-pf1-f177.google.com ([209.85.210.177]:38757) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1mU9YB-0003db-2t for 42323@debbugs.gnu.org; Sat, 25 Sep 2021 11:25:15 -0400 Original-Received: by mail-pf1-f177.google.com with SMTP id k26so6952591pfi.5 for <42323@debbugs.gnu.org>; Sat, 25 Sep 2021 08:25:15 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:in-reply-to:references:user-agent :mime-version:date:message-id:subject:to:cc :content-transfer-encoding; bh=XFFVWTRZclBTBtZmZqmqqRObqFa7h2+FpCJv2XsE5Pw=; b=ss0uW1ifc+l/ecE4X2AuArcrVp7Na5wMpzGxFnxhPXQlrmDB2opP7PLBL+yQmVcUPH 8LCeJ9Nw/IfIiBm+p/AR0RSOxHKLh6l8VtbBkyPc+3XJSLSp8lm1r2C2NzuOhshGL3b0 ff9MRa8wQQllpvaLrNzcH1ZTm+1jXUrrKJ76QNt+kqo0pVcVopW0GTL35CJKBujZF6wA w2i2lk/ZiJSZPtolWVMquLlXdsXXXqgMbSe3rTai/37lxH+jt8CN/uTwkU0SceJA4Ja9 emY2SdtiJ2dafJ27ibb67/tILiPgUG8KGCloVw+DyLa+6zE4/h2YDeFJuVK/xPga+59Z z/kg== X-Gm-Message-State: AOAM532IVKS+MP5eBm7De4lZ/2xzK2waddR6Ar/KcEQK6Qq5tBPA8mjX ZmNMJJnAoiqcNeTlijeddQxZloCgQybAibKa8PQ= X-Google-Smtp-Source: ABdhPJweyy1Pt7pXjRWcg5qQurJ3FC3llwScgO9AkvJFX5IyaHx4HdRbANylDGTFERLwraWSXP4zKwNqf8M6ey2Mlbk= X-Received: by 2002:aa7:9e90:0:b0:43f:2abb:a504 with SMTP id p16-20020aa79e90000000b0043f2abba504mr15297959pfq.35.1632583509388; Sat, 25 Sep 2021 08:25:09 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sat, 25 Sep 2021 08:25:09 -0700 In-Reply-To: <87ft4f3xll.fsf@gnus.org> (Lars Ingebrigtsen's message of "Wed, 09 Dec 2020 14:41:58 +0100") 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:215458 Archived-At: Lars Ingebrigtsen writes: > Drew Adams writes: > >> Or IF understanding the implementation is really necessary, then the >> fact that seq.el is implemented using cl constructs can't be elided. > > This is the current doc string: > > --- > seq-map is a compiled Lisp function in =E2=80=98seq.el=E2=80=99. > > (seq-map FUNCTION SEQUENCE) > > Other relevant functions are documented in the sequence group. > > Return the result of applying FUNCTION to each element of SEQUENCE. > > This is a generic function. > > Implementations: > > #'(sequence sequence) in =E2=80=98seq.el=E2=80=99. > > Undocumented > > #'sequence in =E2=80=98seq.el=E2=80=99. > > Undocumented > --- > > 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? These details are now moved to the bottom of the help screen, below the information that is immediately relevant. Without a major re-design of the help screen, I think that's as good as it gets for now: seq-map is a compiled Lisp function in =E2=80=98seq.el=E2=80=99. (seq-map FUNCTION SEQUENCE) Return the result of applying FUNCTION to each element of SEQUENCE. Other relevant functions are documented in the sequence group. This is a generic function. Implementations: #'(sequence sequence) in =E2=80=98seq.el=E2=80=99. Undocumented #'sequence in =E2=80=98seq.el=E2=80=99. Undocumented I suggest closing this bug report as fixed in 28.1.