[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 report@bugs.python.org http://bugs.python.org/issue15619 _______________________________________

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 report@bugs.python.org http://bugs.python.org/issue15619 _______________________________________

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 report@bugs.python.org http://bugs.python.org/issue15619 _______________________________________

Changes by Georg Brandl georg@python.org:
---------- resolution: -> works for me status: open -> closed
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue15619 _______________________________________

Raymond Hettinger added the comment:
I concur with Georg and Eli. The word "arbitrary" was chosen intentionally.
---------- nosy: +rhettinger
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue15619 _______________________________________
participants (4)
-
Anton Barkovsky
-
Eli Bendersky
-
Georg Brandl
-
Raymond Hettinger