From: Raymond Hettinger <python@rcn.com>
Date: Mon, 13 Oct 2003 17:52:35 +0000 (+0000)
Subject: SF bug #821701:  reduce docs neglect a very important piece of information.
X-Git-Tag: v2.4a1~1431
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=c2a2832bee2d30119981d7924223823b3f099662;p=python

SF bug #821701:  reduce docs neglect a very important piece of information.

Add a note showing which argument is the accumulator.
---

diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex
index 936a023234..a9f3a65a70 100644
--- a/Doc/lib/libfuncs.tex
+++ b/Doc/lib/libfuncs.tex
@@ -816,7 +816,9 @@ class C(object):
   Apply \var{function} of two arguments cumulatively to the items of
   \var{sequence}, from left to right, so as to reduce the sequence to
   a single value.  For example, \code{reduce(lambda x, y: x+y, [1, 2,
-  3, 4, 5])} calculates \code{((((1+2)+3)+4)+5)}.  If the optional
+  3, 4, 5])} calculates \code{((((1+2)+3)+4)+5)}.  The left argument,
+  \var{x}, is the accumulated value and the right argument, \var{y},
+  is the update value from the \var{sequence}.  If the optional
   \var{initializer} is present, it is placed before the items of the
   sequence in the calculation, and serves as a default when the
   sequence is empty.  If \var{initializer} is not given and