[docs] [issue9562] Slightly misleading wording in documentation of dict.update

Mitchell Model report at bugs.python.org
Tue Aug 10 22:50:03 CEST 2010

New submission from Mitchell Model <mlm at acm.org>:

The documentation of dict.update says that it "accepts either another dictionary object or an iterable of key/value pairs (as a tuple or other iterable of length two)" The parenthesized phrase is slightly misleading in that it could be interpreted as requiring the argument to be an iterable of length two, whereas the argument should be an iterable of iterables of length 2 (if not a dictionary). Suggest rewriting in the plural:
    (as tuples or other iterables of length two)

assignee: docs at python
components: Documentation
messages: 113557
nosy: MLModel, docs at python
priority: normal
severity: normal
status: open
title: Slightly misleading wording in documentation of dict.update
versions: Python 2.6, Python 2.7, Python 3.1

Python tracker <report at bugs.python.org>

More information about the docs mailing list