[Python-checkins] cpython (2.7): Issue #10771: Clarify that descriptors get used in an *owner* class or one of

[raymond.hettinger]

http://hg.python.org/cpython/rev/f28565867d22
changeset:   68855:f28565867d22
branch:      2.7
parent:      68845:42816be02b9b
user:        Raymond Hettinger <python at rcn.com>
date:        Tue Mar 22 17:51:57 2011 -0700
summary:
  Issue #10771: Clarify that descriptors get used in an *owner* class or one of its parents.

files:
  Doc/reference/datamodel.rst

diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -1539,11 +1539,11 @@
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
 The following methods only apply when an instance of the class containing the
-method (a so-called *descriptor* class) appears in the class dictionary of
-another new-style class (known as the *owner* class) or one of its
-descendants.  In the examples below, "the attribute" refers to the attribute
-whose name is the key of the property in the owner class' ``__dict__``.
-Descriptors can only be implemented as new-style classes themselves.
+method (a so-called *descriptor* class) appears in an *owner* class (the
+descriptor must be in either the owner's class dictionary or in the class
+dictionary for one of its parents).  In the examples below, "the attribute"
+refers to the attribute whose name is the key of the property in the owner
+class' :attr:`__dict__`.
 
 
 .. method:: object.__get__(self, instance, owner)

-- 
Repository URL: http://hg.python.org/cpython