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
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
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
Raymond Hettinger added the comment:
I concur with Georg and Eli. The word "arbitrary" was chosen intentionally.
---------- nosy: +rhettinger