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#24014: 24.5; doc string of `cl-reduce' Date: Sat, 23 Oct 2021 10:32:31 -0700 Message-ID: References: <18e97f8d-f6f8-4b4c-9d4c-20eb8664483e@default> <87zipgmf51.fsf@web.de> <878tx0hskr.fsf@petton.fr> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="31161"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: Michael Heerdegen , Nicolas Petton , 24014@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Oct 23 19:33:17 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 1meKtQ-0007rS-Bx for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 23 Oct 2021 19:33:16 +0200 Original-Received: from localhost ([::1]:46154 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1meKtO-0002RC-CQ for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 23 Oct 2021 13:33:14 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50696) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1meKtE-0002Pj-2E for bug-gnu-emacs@gnu.org; Sat, 23 Oct 2021 13:33:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:53777) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1meKtC-00025G-0x for bug-gnu-emacs@gnu.org; Sat, 23 Oct 2021 13:33:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1meKtB-0002KL-Oo for bug-gnu-emacs@gnu.org; Sat, 23 Oct 2021 13:33: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, 23 Oct 2021 17:33:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24014 X-GNU-PR-Package: emacs Original-Received: via spool by 24014-submit@debbugs.gnu.org id=B24014.16350103628906 (code B ref 24014); Sat, 23 Oct 2021 17:33:01 +0000 Original-Received: (at 24014) by debbugs.gnu.org; 23 Oct 2021 17:32:42 +0000 Original-Received: from localhost ([127.0.0.1]:37087 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meKss-0002Ja-1h for submit@debbugs.gnu.org; Sat, 23 Oct 2021 13:32:42 -0400 Original-Received: from mail-pj1-f52.google.com ([209.85.216.52]:43871) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1meKsn-0002Io-0S for 24014@debbugs.gnu.org; Sat, 23 Oct 2021 13:32:38 -0400 Original-Received: by mail-pj1-f52.google.com with SMTP id k2-20020a17090ac50200b001a218b956aaso1068492pjt.2 for <24014@debbugs.gnu.org>; Sat, 23 Oct 2021 10:32:36 -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; bh=Ml3B+5Y2mCGFH1raRS6mh+d1kEJO+vf6Y+HUsqYpuw0=; b=xKdQu6ZrSwKdU6vmDKa9NvFjobzEg9LYra9FZLQLyiWAEby6zjaOWO/LBuUxfDMOe8 r5rg/ynNwuArwe3A9TFv4lsuExCoI0s7prs7B5StNtnHdNiN2+3rjQfytYNDLJL6urHW lTyN1cQgroBaq4UIWaHegyeqQj4EZIpaSBXRoKC8qRSBovfvjLc7MYbhq2ngQwiJpMRk ERqtspmiSjsN1p6buPYZVzH/dAo8AwIo32czlAY/Rf5HqV4WA+4VpGOLYeydiAdBZoGz CJx6jKn4V/kPJyY63eSE4v2dUbr8PtlBqYfi7Low81FEtBBolSmB1xdaeZCyg4msIfg5 rPQQ== X-Gm-Message-State: AOAM532Y1QrjdGkm7zRSX0Q3JP2kX+oE9mq+fwFaYeDLdoO29zBRvZAI mKs3T6ixcsTHEIhb819nV5lLGr9WsaJBbuMtxJxFw00CIQs= X-Google-Smtp-Source: ABdhPJz3lyPIDswgt0gnEbAyQ1m4dXcWbvijeCVyrKoUJhiXfS1Dx/mOz+diVGP5JMzwUQ4bN/0ALSf1AmAwH5MY4e0= X-Received: by 2002:a17:90a:d917:: with SMTP id c23mr1393060pjv.133.1635010351400; Sat, 23 Oct 2021 10:32:31 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Sat, 23 Oct 2021 10:32:31 -0700 In-Reply-To: (Drew Adams's message of "Sun, 17 Jul 2016 21:44:50 -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:218009 Archived-At: close 24014 28.1 thanks Drew Adams writes: >> >> Please state in the doc string what the function does. IOW, >> >> explain/describe/specify what "reduce" means. Do not suppose that Emacs >> >> Lisp users are all familiar with functional programming etc. >> >> The documentation of `seq-reduce' is probably not perfect, but at least >> it tries to explain what reducing means: >> >> Return the result of calling FUNCTION with INITIAL-VALUE and the >> first element of SEQUENCE, then calling FUNCTION with that result and >> the second element of SEQUENCE, then with that result and the third >> element of SEQUENCE, etc. >> >> If SEQUENCE is empty, return INITIAL-VALUE and FUNCTION is not called. > > Much better, yes. This is the right level at which to describe what > it does for most programmers, IMO. Nicolas updated the docstring, and I have now done the same change in cl.texi on the emacs-28 branch (commit 43914ab01f). It is the same text as above, just formatted for texinfo, so it should be understandable to us mere programmers. I'm consequently closing this bug report.