From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#24014: 24.5; doc string of `cl-reduce' Date: Sun, 17 Jul 2016 21:44:50 -0700 (PDT) Message-ID: References: <18e97f8d-f6f8-4b4c-9d4c-20eb8664483e@default> <87zipgmf51.fsf@web.de> <878tx0hskr.fsf@petton.fr> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1468817435 16912 80.91.229.3 (18 Jul 2016 04:50:35 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 18 Jul 2016 04:50:35 +0000 (UTC) Cc: 24014@debbugs.gnu.org To: Nicolas Petton , Michael Heerdegen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jul 18 06:50:22 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 1bP0VW-0008NN-Sz for geb-bug-gnu-emacs@m.gmane.org; Mon, 18 Jul 2016 06:50:19 +0200 Original-Received: from localhost ([::1]:44311 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bP0VW-0002Di-4I for geb-bug-gnu-emacs@m.gmane.org; Mon, 18 Jul 2016 00:50:18 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:49082) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bP0RS-0005VJ-Vo for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 00:46:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bP0RO-0006xL-PK for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 00:46:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:42664) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bP0RO-0006xH-LV for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 00:46:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1bP0RO-0000be-GO for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2016 00:46:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 18 Jul 2016 04:46:02 +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: Original-Received: via spool by 24014-submit@debbugs.gnu.org id=B24014.14688171032262 (code B ref 24014); Mon, 18 Jul 2016 04:46:02 +0000 Original-Received: (at 24014) by debbugs.gnu.org; 18 Jul 2016 04:45:03 +0000 Original-Received: from localhost ([127.0.0.1]:55001 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bP0QR-0000aQ-5c for submit@debbugs.gnu.org; Mon, 18 Jul 2016 00:45:03 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:49311) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1bP0QP-0000Zf-Jj for 24014@debbugs.gnu.org; Mon, 18 Jul 2016 00:45:01 -0400 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id u6I4isGY028045 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 18 Jul 2016 04:44:54 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id u6I4irCr010756 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Mon, 18 Jul 2016 04:44:53 GMT Original-Received: from abhmp0011.oracle.com (abhmp0011.oracle.com [141.146.116.17]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id u6I4ipVk026504; Mon, 18 Jul 2016 04:44:52 GMT In-Reply-To: <878tx0hskr.fsf@petton.fr> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6744.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] 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:121209 Archived-At: > >> Please state in the doc string what the function does. IOW, > >> explain/describe/specify what "reduce" means. Do not suppose that Ema= cs > >> Lisp users are all familiar with functional programming etc. >=20 > The documentation of `seq-reduce' is probably not perfect, but at least > it tries to explain what reducing means: >=20 > 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. >=20 > 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.