Ezio Melotti <ezio.melotti@gmail.com> added the comment: Indeed that paragraph is not really clear. I had to read it till the end ("verbs for methods and nouns for data attributes") to figure out what it was talking about. Even then it's still not clear what it's trying to say. I *think* it means that if you have a class Foo with a method bar, and you do Foo.bar = 'data', the method will be overridden (so you won't be able to do Foo.bar for the 'data' and Foo.bar() for the method), but the opposite is also true. Moreover I find both the suggestions for avoiding conflicts (capitalizing method names and/or using an underscore) wrong (both against PEP8). Also it never happened to me to have an attribute with the same name of a method, and I think in general it's not a common case (becase, as the paragraph says, methods are verbs and attributes nouns). The whole thing could be rewritten to just say that an attribute name always refers to a single object, either to a method or to some "data". ---------- nosy: +eric.araujo, ezio.melotti, terry.reedy versions: +Python 3.2, Python 3.3 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue12634> _______________________________________

Terry J. Reedy <tjreedy@udel.edu> added the comment: That sentence is wrong to imply that there is anything special about data versus method attributes with respect to overriding -- or that attributes are special when it comes to names in a single namespace. What I think the paragraph should say, if not just deleted, is something like. "Instance attributes hide class attributes. Instance data names are often intended to override class data names. But instance data names masking methods names is likely a mistake. This can be avoided by using verbs for method names and nouns for data names." ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue12634> _______________________________________

Ezio Melotti added the comment: See also #16048. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue12634> _______________________________________

Changes by Yongzhi Pan <fossilet@users.sourceforge.net>: ---------- nosy: +fossilet _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue12634> _______________________________________

Yogesh Chaudhari added the comment: Based on Teery's comments, this patch makes the changes to the random remarks section of the class documentation ---------- keywords: +patch nosy: +Yogesh.Chaudhari Added file: http://bugs.python.org/file30134/issue12634.patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue12634> _______________________________________

Changes by Yogesh Chaudhari <mr.yogesh@gmail.com>: ---------- hgrepos: -188 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue12634> _______________________________________

Change by Raymond Hettinger <raymond.hettinger@gmail.com>: ---------- versions: +Python 3.8, Python 3.9 -Python 2.7, Python 3.2, Python 3.3, Python 3.4 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue12634> _______________________________________

Raymond Hettinger <raymond.hettinger@gmail.com> added the comment: New changeset 483ae0cf1dcf46f8b71c4bf32419dd138e908553 by Raymond Hettinger in branch 'master': bpo-12634: Clarify an awkward section of the tutorial (GH-15406) https://github.com/python/cpython/commit/483ae0cf1dcf46f8b71c4bf32419dd138e9... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue12634> _______________________________________

Change by Raymond Hettinger <raymond.hettinger@gmail.com>: ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue12634> _______________________________________