[issue7447] Sum() doc and behavior mismatch

Terry J. Reedy report at bugs.python.org
Mon Jul 26 00:01:59 CEST 2010


Terry J. Reedy <tjreedy at udel.edu> added the comment:

Leonard, that you for the patch, in particular, the list of hints. I think the first is good but overly specific. It also has an extra '.itertools' in the path. Now:

'''
+      - To concatenate a list of lists ``lol`` use ``list(itertools.chain.from_iterable(lol))``
+        (see :func:`from_iterable <itertools.itertools.chain.from_iterable>`).
'''

How about instead"
'''
+      - To concatenate an iterable of iterables, such as a list of lists,
+        see :func:`from_iterable <itertools.chain.from_iterable>`
+        and call the appropriate constructor on the result, such as :class: `list`.
'''
?

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue7447>
_______________________________________


More information about the Python-bugs-list mailing list