From 74723364444dec7003940cb6f226ec1b5947e877 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Martin=20v=2E=20L=C3=B6wis?= <martin@v.loewis.de>
Date: Sat, 31 May 2003 08:02:38 +0000
Subject: Patch #744877: Explain filter in terms of list comprehension. Remove
 explanation of int in terms of string.atoi. Explain sum in terms of reduce.

---
 Doc/lib/libfuncs.tex | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/Doc/lib/libfuncs.tex b/Doc/lib/libfuncs.tex
index 4020e8b..2924f78 100644
--- a/Doc/lib/libfuncs.tex
+++ b/Doc/lib/libfuncs.tex
@@ -439,6 +439,11 @@ class C:
   is always a list.  If \var{function} is \code{None}, the identity
   function is assumed, that is, all elements of \var{list} that are false
   (zero or empty) are removed.
+
+  Note that \code{filter(function, list)} equals
+  \code{[item for item in list if function(item)]} if function is not
+  \code{None} and \code{[item for item in list if item]} if function is
+  None.
 \end{funcdesc}
 
 \begin{funcdesc}{float}{x}
@@ -537,9 +542,8 @@ class C:
 \begin{funcdesc}{int}{x\optional{, radix}}
   Convert a string or number to a plain integer.  If the argument is a
   string, it must contain a possibly signed decimal number
-  representable as a Python integer, possibly embedded in whitespace;
-  this behaves identical to \code{string.atoi(\var{x}\optional{,
-  \var{radix}})}.  The \var{radix} parameter gives the base for the
+  representable as a Python integer, possibly embedded in whitespace.
+  The \var{radix} parameter gives the base for the
   conversion and may be any integer in the range [2, 36], or zero.  If
   \var{radix} is zero, the proper radix is guessed based on the
   contents of string; the interpretation is the same as for integer
@@ -904,6 +908,7 @@ class C:
   The \var{sequence}'s items are normally numbers, and are not allowed
   to be strings.  The fast, correct way to concatenate sequence of
   strings is by calling \code{''.join(\var{sequence})}.
+  Note that \code{sum(range(n), m)} equals \code{reduce(operator.add, range(n), m)}
   \versionadded{2.3}
 \end{funcdesc}
 
-- 
cgit v0.12

