Minor error in sum() docs

[kjohnson]

BPO	1619674
Nosy	@akuchling

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = 'https://github.com/akuchling'
closed_at = <Date 2006-12-20.20:12:13.000>
created_at = <Date 2006-12-20.19:10:05.000>
labels = ['docs']
title = 'Minor error in sum() docs'
updated_at = <Date 2006-12-20.20:12:13.000>
user = 'https://bugs.python.org/kjohnson'

bugs.python.org fields:

activity = <Date 2006-12-20.20:12:13.000>
actor = 'akuchling'
assignee = 'akuchling'
closed = True
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2006-12-20.19:10:05.000>
creator = 'kjohnson'
dependencies = []
files = []
hgrepos = []
issue_num = 1619674
keywords = []
message_count = 2.0
messages = ['30847', '30848']
nosy_count = 2.0
nosy_names = ['akuchling', 'kjohnson']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = None
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue1619674'
versions = ['Python 2.5']

[kjohnson]

In 2.1 Built-in Functions, the docs for sum() say it takes a sequence argument. IIUC the actual requirement is for an iterable which is a weaker requirement than a sequence. For example the argument can be a generator expression or a dict, neither of which is a sequence. Also there is a missing 'a' in the fourth sentence.

Here is a suggested rewrite:

sum(iterable[, start])
    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...

[akuchling]

Thanks for pointing this out; I've changed the description of sum in rev. 53112.