[issue15619] set.pop() documentation is confusing
New submission from Anton Barkovsky:
I've seen people being confused by the documentation for set.pop() method. It makes it look like the element is selected randomly while it's
just unspecified.
I'm attaching a patch that clarifies the doc, tested on 3.3, 3.2 and 2.7
----------
assignee: docs@python
components: Documentation
files: set_pop_doc.patch
keywords: patch
messages: 167895
nosy: anton.barkovsky, docs@python
priority: normal
severity: normal
status: open
title: set.pop() documentation is confusing
versions: Python 2.7, Python 3.2, Python 3.3
Added file: http://bugs.python.org/file26759/set_pop_doc.patch
_______________________________________
Python tracker
Georg Brandl added the comment:
Sorry, I don't see how "arbitrary" implies "random". So I'm -1 on making the docs more verbose for no apparent gain.
----------
nosy: +georg.brandl
_______________________________________
Python tracker
Eli Bendersky added the comment:
I agree with Georg. As far as I understand the word "arbitrary" - it describes the situation exactly.
----------
nosy: +eli.bendersky
_______________________________________
Python tracker
Changes by Georg Brandl
Raymond Hettinger added the comment:
I concur with Georg and Eli. The word "arbitrary" was chosen intentionally.
----------
nosy: +rhettinger
_______________________________________
Python tracker
participants (4)
-
Anton Barkovsky
-
Eli Bendersky
-
Georg Brandl
-
Raymond Hettinger