[Python-checkins] r86069 - python/branches/release27-maint/Doc/library/functions.rst
raymond.hettinger
python-checkins at python.org
Sun Oct 31 22:28:53 CET 2010
Author: raymond.hettinger
Date: Sun Oct 31 22:28:53 2010
New Revision: 86069
Log:
Issue 7447: Improve docs for sum().
Modified:
python/branches/release27-maint/Doc/library/functions.rst
Modified: python/branches/release27-maint/Doc/library/functions.rst
==============================================================================
--- python/branches/release27-maint/Doc/library/functions.rst (original)
+++ python/branches/release27-maint/Doc/library/functions.rst Sun Oct 31 22:28:53 2010
@@ -1227,10 +1227,13 @@
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)``. Note that
- ``sum(range(n), m)`` is equivalent to ``reduce(operator.add, range(n), m)``
- 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`.
.. versionadded:: 2.3
More information about the Python-checkins
mailing list