From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: =?UTF-8?Q?Cl=C3=A9ment?= Pit--Claudel Newsgroups: gmane.emacs.bugs Subject: bug#24014: 24.5; doc string of `cl-reduce' Date: Mon, 18 Jul 2016 10:54:21 +0200 Message-ID: <578C993D.10507@gmail.com> References: <18e97f8d-f6f8-4b4c-9d4c-20eb8664483e@default> <87zipgmf51.fsf@web.de> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="bCpfKaWkxsM5b5VKLA5gsBtgEXP9IlQuu" X-Trace: ger.gmane.org 1468832281 2124 80.91.229.3 (18 Jul 2016 08:58:01 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 18 Jul 2016 08:58:01 +0000 (UTC) To: 24014@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jul 18 10:57:49 2016 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1bP4N1-0006W7-FJ for geb-bug-gnu-emacs@m.gmane.org; Mon, 18 Jul 2016 10:57:47 +0200 Original-Received: from localhost ([::1]:45237 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bP4N0-0001S8-9K for geb-bug-gnu-emacs@m.gmane.org; Mon, 18 Jul 2016 04:57:46 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58259) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bP4KQ-0007mZ-5S for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 04:55:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bP4KM-0000Hp-5f for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 04:55:06 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:42685) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bP4KM-0000Hl-2S for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 04:55:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bP4KL-0006XN-Tt for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 04:55:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: =?UTF-8?Q?Cl=C3=A9ment?= Pit--Claudel Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 18 Jul 2016 08:55:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 24014 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.146883208325098 (code B ref -1); Mon, 18 Jul 2016 08:55:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 18 Jul 2016 08:54:43 +0000 Original-Received: from localhost ([127.0.0.1]:55022 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bP4K3-0006Wj-9E for submit@debbugs.gnu.org; Mon, 18 Jul 2016 04:54:43 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:38925) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bP4K1-0006WV-I6 for submit@debbugs.gnu.org; Mon, 18 Jul 2016 04:54:41 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bP4Jv-0000BW-HQ for submit@debbugs.gnu.org; Mon, 18 Jul 2016 04:54:36 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:59942) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bP4Jv-0000Ab-DV for submit@debbugs.gnu.org; Mon, 18 Jul 2016 04:54:35 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:58105) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bP4Jt-0007Iw-1y for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 04:54:33 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bP4Jo-00008Q-TU for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 04:54:32 -0400 Original-Received: from mout.kundenserver.de ([212.227.126.187]:61859) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bP4Jo-00007u-Ic for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 04:54:28 -0400 Original-Received: from [192.168.1.82] ([109.24.225.43]) by mrelayeu.kundenserver.de (mreue004) with ESMTPSA (Nemesis) id 0MTKyZ-1bpIgO0dNv-00SKZd for ; Mon, 18 Jul 2016 10:54:27 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.8.0 In-Reply-To: X-Provags-ID: V03:K0:rELnA4qE3AyroK2k/He1y/euaMDCP2RkdJdm3q3kxjm8leXD9NG wVlHDXe+n32VFbWnY3OmjMLu6MK3PATWBInDVdHZa0aiR5a/fgY8DYOYq3mMAINzErYdQZf v8kTm3BJknjVXThqFFpAZ0MpTtqlKbHhW+iCpIjfsrBaNWch02BLm4kuqSl98WQG5LD6aWL xE88wkBN5Q73IlzgBzjQQ== X-UI-Out-Filterresults: notjunk:1;V01:K0:NkfZ1wXlCro=:Fvin/OEUrBjt9EKff20FIQ gd0EDGDpzMiHJQ0wEPk66XJ3sXIiWlaIjd2FNSs55BYwWaDlJFdLtmTpBtLHVcqa2hCr40jJZ 8UwjOmdglG6Rr2Vm5WVuUPL2UjHRvcbgjALXPe3iqJXdcQresAI0FgWKSb4zvLiHZxYJwq2iP zvSS9gwWWx4XgY4uybJKeJTg4py/H3EVY+qQ39ft8B0i/yJ8FwEm3aeMEp0ukTE/loySLCdmd 94QUn/mLIibck1H90xxleoMvzbPbX9YwWeecPyuo3u5MCproHBlvsn3evm3AvFP7F4FGo3nk3 8JkSLAbRShUJRy6XEe1MLeIikVLVkyOBl5sV8V+pop59NH/GWnRAe+sgzskU5Z+f0OalTyJPb 4W7kW+PiISSzRvAHhybsw5UidWfCRtfNF2UNa7Mr05DOEZn8SmzoWkQrgFwCxEisxfk74kNrX CyXOhcGOwaUXalqU9gcJHDqm+RYEj3jgtMIgmZlIOa7xKT+0qf4sKqVQbtzOTeE8lpnwYRnxo hjrm3aKOAeHnCOdgTahJg32vBUbgL6JmhArdrPKYx7mq110onCA/XN3c5dNPhyqcyreHVZy2t t0D7OIqmpM4cqx5vMLi1u/M9SZn7IqgMek+DccWLuJ8AyZ2EsucfjH79kGGs5mEsxt1g5WeOy h86QRqqJPwaCWeI4hpetQOHvGhi3dtsjS/v0Mqq1OsvHgnpNitV632ww9tL/9s517bcs= X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:121210 Archived-At: This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --bCpfKaWkxsM5b5VKLA5gsBtgEXP9IlQuu Content-Type: multipart/mixed; boundary="TNDVnvs1irS1Fo21BMbCihm6hpUFI0jJ9" From: =?UTF-8?Q?Cl=c3=a9ment_Pit--Claudel?= To: bug-gnu-emacs@gnu.org Message-ID: <578C993D.10507@gmail.com> Subject: Re: bug#24014: 24.5; doc string of `cl-reduce' References: <18e97f8d-f6f8-4b4c-9d4c-20eb8664483e@default> <87zipgmf51.fsf@web.de> In-Reply-To: --TNDVnvs1irS1Fo21BMbCihm6hpUFI0jJ9 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On 2016-07-18 06:41, Drew Adams wrote: > Even providing a functional-programming definition of `reduce' is > better than just describing it in abstract terms, if we can't come > up with a more down-to-earth description. What about adding a few examples? Something like this maybe? (cl-reduce f '(1 2 3 4 5)) =E2=86=94 (f (f (f (f 1 2) 3) 4) 5) (cl-reduce f '(1 2 3 4 5) :initial-value 0) =E2=86=94 (f (f (f (f (f 0 1) 2) 3) 4) 5) (cl-reduce f '(1 2 3 4 5) :from-end t) =E2=86=94 (f 1 (f 2 (f 3 (f 4 5)))) (cl-reduce f '(1 2 3 4 5) :from-end t :initial-value 0) =E2=86=94 (f 1 (f 2 (f 3 (f 4 (f 5 0))))) --TNDVnvs1irS1Fo21BMbCihm6hpUFI0jJ9-- --bCpfKaWkxsM5b5VKLA5gsBtgEXP9IlQuu Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 iQIcBAEBCAAGBQJXjJlCAAoJEPqg+cTm90wjkx0QAIawX6iGOh8lpsx+TVZO2ey5 WE0g0+ShF1qo9rJ/BziPOPpIlo68JJTcze4SQ7tgD6SK4dnjSHWmjAQeKhM4vQdY MnoCg3Kw6CVX8D6zjJutr+2zMfAlcXFxXFcvamHeUzazE+4aNuwHmtqi2LNidExd JSFFm4W7wgdUFbCEYU/+KXDcrSjmh9q3mllxsJY4t5Zpe4xOkCkEn1WKh1m9oUK0 nE35xBoDKU+RfCeAcavhGqMnHH29UkDISvw0MlbeRvEbez09ASr2CFAGuKFIvb+5 a2rFZCDWZ5Q4skHghyY3MXdIY+q9f18CGbeGgmtiU6cNRPCSNs8KKV1q18D1tKAa axwULdlHa6Ye9FNDBLGdLAXb8XfRO2GF8cjpWKo8Fanftf9hLtnxbCEBKD8XxZS1 Wfii80M34ziHVo8TLdD8dxs7wAaSws4sywvEJVsETbbEzKpALrIamSDefrUE5yOM eSgRNhRMRjlxBibuO9nOMbtrGO32Gs/Qug9gGTCKws39qni7IKUCPqkNJ121EakA fSnta3QWNF8ZJvqZ2mqWgaM02PdHdATtYIjH0o78KfNsGgXqu26z7wUw54D+kqjn 6RNsIZXQQwGcDLQ7wnVqEFxUGsva7aT9C0zePX4MSeVHAxgLLpOQ58TwnrweMGNl 65kZAu/V6/yreU7yiRqT =txYh -----END PGP SIGNATURE----- --bCpfKaWkxsM5b5VKLA5gsBtgEXP9IlQuu--