[issue36198] Misleading in library/sets document
New submission from Han <phoenix.seek@gmail.com>: Doc/library/sets.rst said operation s.update(t)'s result is "return set s with elements added from t". But update()'s return value is None. I think change it to "set s with elements added from t" would be better. So are operations intersection_update(), difference_update(), and symmetric_difference_update(). ---------- assignee: docs@python components: Documentation messages: 337192 nosy: DeadmanWalking, docs@python priority: normal severity: normal status: open title: Misleading in library/sets document versions: Python 2.7 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue36198> _______________________________________
Karthikeyan Singaravelan <tir.karthi@gmail.com> added the comment: To add to this is actually present in sets module documentation which has been deprecated since 2.6 though the report is true that the methods don't return a set. Link : https://docs.python.org/2/library/sets.html#set-objects ---------- nosy: +rhettinger, xtreak _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue36198> _______________________________________
Josh Rosenberg <shadowranger+python@gmail.com> added the comment: The "returns" bit is accurate when referring to the in-place operator overloads (__ior__), so those lines may have been written referring to the overloads described on the same line (they shouldn't have been written that way, but that would explain why only the methods with in-place overload equivalents use the word "returns"). Either way, sets was deprecated in 2.6, largely pointless in every version but 2.3 (module added in 2.3, built-in set/frozenset types added 2.4), and gone in 3.0+ (and 2.7 is EOL within the year). Do we even do doc updates for stuff this dead? ---------- nosy: +josh.r _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue36198> _______________________________________
Han <phoenix.seek@gmail.com> added the comment: Thanks, I didn't notice the Deprecated sign on the Sets page. ---------- stage: -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue36198> _______________________________________
participants (3)
-
Han -
Josh Rosenberg
-
Karthikeyan Singaravelan