[issue11713] collections.deque docstring wrong/misleading

Davide Rizzo report at bugs.python.org
Tue Mar 29 21:56:50 CEST 2011


New submission from Davide Rizzo <sorcio at gmail.com>:

collections.deque docstring is:
'deque(iterable[, maxlen]) --> deque object\n\nBuild an ordered collection accessible from endpoints only.'

As it reads now, it seems to imply that only endpoints can be read/modified. The rst correctly states that random access is possible (though slow).

__ap__ suggestion is "Build an ordered collection with optimized access from its endpoints".

----------
components: Library (Lib)
messages: 132513
nosy: davide.rizzo, rhettinger
priority: normal
severity: normal
status: open
title: collections.deque docstring wrong/misleading
versions: Python 2.7, Python 3.1, Python 3.2, Python 3.3

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


More information about the Python-bugs-list mailing list