From 6f7993765ac0989b5d13084240797913627a31d8 Mon Sep 17 00:00:00 2001 From: Guido van Rossum Date: Thu, 20 Sep 2001 20:46:19 +0000 Subject: 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. --- Objects/complexobject.c | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) (limited to 'Objects/complexobject.c') diff --git a/Objects/complexobject.c b/Objects/complexobject.c index a2ccadb78a..191dcba73e 100644 --- a/Objects/complexobject.c +++ b/Objects/complexobject.c @@ -625,9 +625,11 @@ static PyMethodDef complex_methods[] = { {NULL, NULL} /* sentinel */ }; -static struct memberlist complex_members[] = { - {"real", T_DOUBLE, offsetof(PyComplexObject, cval.real), 0}, - {"imag", T_DOUBLE, offsetof(PyComplexObject, cval.imag), 0}, +static PyMemberDef complex_members[] = { + {"real", T_DOUBLE, offsetof(PyComplexObject, cval.real), 0, + "the real part of a complex number"}, + {"imag", T_DOUBLE, offsetof(PyComplexObject, cval.imag), 0, + "the imaginary part of a complex number"}, {0}, }; -- cgit v1.2.1