[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