This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: collections.deque docstring wrong/misleading
Type: Stage:
Components: Library (Lib) Versions: Python 3.1, Python 3.2, Python 3.3, Python 2.7
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: rhettinger Nosy List: davide.rizzo, ezio.melotti, python-dev, rhettinger
Priority: low Keywords:

Created on 2011-03-29 19:56 by davide.rizzo, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Messages (3)
msg132513 - (view) Author: Davide Rizzo (davide.rizzo) * Date: 2011-03-29 19:56
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".
msg132561 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2011-03-30 00:33
New changeset f4e6e18cae4b by Raymond Hettinger in branch '2.7':
Issue 11713: clarify docstring for collections.deque()
http://hg.python.org/cpython/rev/f4e6e18cae4b

New changeset 36344c9505b2 by Raymond Hettinger in branch '3.1':
Issue 11713: clarify docstring for collections.deque()
http://hg.python.org/cpython/rev/36344c9505b2
msg132562 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2011-03-30 00:38
New changeset 075637897403 by Raymond Hettinger in branch '3.2':
Issue 11713: clarify docstring for collections.deque()
http://hg.python.org/cpython/rev/075637897403

New changeset 80e71592b114 by Raymond Hettinger in branch 'default':
Issue 11713: clarify docstring for collections.deque()
http://hg.python.org/cpython/rev/80e71592b114
History
Date User Action Args
2022-04-11 14:57:15adminsetgithub: 55922
2011-03-30 00:39:13rhettingersetstatus: open -> closed
resolution: fixed
2011-03-30 00:38:37python-devsetmessages: + msg132562
2011-03-30 00:33:44python-devsetnosy: + python-dev
messages: + msg132561
2011-03-29 20:36:53rhettingersetpriority: normal -> low
assignee: rhettinger
2011-03-29 19:57:43ezio.melottisetnosy: + ezio.melotti
2011-03-29 19:56:46davide.rizzocreate