diff options
| author | Guido van Rossum <guido@python.org> | 2001-09-20 20:46:19 (GMT) |
|---|---|---|
| committer | Guido van Rossum <guido@python.org> | 2001-09-20 20:46:19 (GMT) |
| commit | 6f7993765ac0989b5d13084240797913627a31d8 (patch) | |
| tree | 51dd234049db1eb78c6dd25d23ec687bf91d817c /Objects/classobject.c | |
| parent | e0af35eb694179d8da5d3208ffdfb92e5356335f (diff) | |
| download | cpython-6f7993765ac0989b5d13084240797913627a31d8.zip cpython-6f7993765ac0989b5d13084240797913627a31d8.tar.gz cpython-6f7993765ac0989b5d13084240797913627a31d8.tar.bz2 | |
Add optional docstrings to member descriptors. For backwards
compatibility, this required all places where an array of "struct
memberlist" structures was declared that is referenced from a type's
tp_members slot to change the type of the structure to PyMemberDef;
"struct memberlist" is now only used by old code that still calls
PyMember_Get/Set. The code in PyObject_GenericGetAttr/SetAttr now
calls the new APIs PyMember_GetOne/SetOne, which take a PyMemberDef
argument.
As examples, I added actual docstrings to the attributes of a few
types: file, complex, instance method, super, and xxsubtype.spamlist.
Also converted the symtable to new style getattr.
Diffstat (limited to 'Objects/classobject.c')
| -rw-r--r-- | Objects/classobject.c | 11 |
1 files changed, 7 insertions, 4 deletions
diff --git a/Objects/classobject.c b/Objects/classobject.c index 3845dfc..f8ee6fd 100644 --- a/Objects/classobject.c +++ b/Objects/classobject.c @@ -2006,10 +2006,13 @@ PyMethod_New(PyObject *func, PyObject *self, PyObject *class) #define OFF(x) offsetof(PyMethodObject, x) -static struct memberlist instancemethod_memberlist[] = { - {"im_class", T_OBJECT, OFF(im_class), READONLY|RESTRICTED}, - {"im_func", T_OBJECT, OFF(im_func), READONLY|RESTRICTED}, - {"im_self", T_OBJECT, OFF(im_self), READONLY|RESTRICTED}, +static PyMemberDef instancemethod_memberlist[] = { + {"im_class", T_OBJECT, OFF(im_class), READONLY|RESTRICTED, + "the class associated with a method"}, + {"im_func", T_OBJECT, OFF(im_func), READONLY|RESTRICTED, + "the function (or other callable) implementing a method"}, + {"im_self", T_OBJECT, OFF(im_self), READONLY|RESTRICTED, + "the instance to which a method is bound; None for unbound methods"}, {NULL} /* Sentinel */ }; |