From: Raymond Hettinger Date: Sun, 31 Oct 2010 21:27:50 +0000 (+0000) Subject: Issue 7447: Improve docs for sum(). X-Git-Tag: v3.1.3rc1~60 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=30bf6e836e4d671fd487673134c6041a6fe77204;p=thirdparty%2FPython%2Fcpython.git Issue 7447: Improve docs for sum(). --- diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst index e97be7b9d03e..5c80f9406478 100644 --- a/Doc/library/functions.rst +++ b/Doc/library/functions.rst @@ -1100,10 +1100,13 @@ are always available. They are listed here in alphabetical order. Sums *start* and the items of an *iterable* from left to right and returns the total. *start* defaults to ``0``. The *iterable*'s items are normally numbers, - and are not allowed to be strings. The fast, correct way to concatenate a - sequence of strings is by calling ``''.join(sequence)``. To add floating - point values with extended precision, see :func:`math.fsum`\. + and the start value is not allowed to be a string. + For some use cases, there a good alternatives to :func:`sum`. + The preferred, fast way to concatenate a sequence of strings is by calling + ``''.join(sequence)``. To add floating point values with extended precision, + see :func:`math.fsum`\. To concatenate a series of iterables, consider using + :func:`itertools.chain`. .. function:: super([type[, object-or-type]])