This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author terry.reedy
Recipients docs@python, eli.bendersky, eric.araujo, eric.snow, python-dev, terry.reedy
Date 2011-08-15.00:21:27
SpamBayes Score 8.052631e-05
Marked as misclassified No
Message-id <1313367688.35.0.32127762405.issue12672@psf.upfronthosting.co.za>
In-reply-to
Content
I agree that the sentence is a bit confusing and the 'object method' ambiguous. I suspect that the sentence was written years ago. In current Python, [].append is a bound method of class 'builtin_function_or_method'. I *suspect* that the intended contrast, and certainly the important one, is that between C functions, which get added to PyTypeObject structures, and their Python object wrappers that are visible from Python, but which must not be put in the type structure. The varieties of wrappers are irrelevant in this context and for the purpose of avoiding that mistake. So I would rewrite the sentence as:

These C functions are called “type methods” to distinguish them from Python wrapper objects, such as ``list.append`` or ``[].append``, visible in Python code.

Looking further down,
"Now if you go and look up the definition of PyTypeObject in object.h you’ll see that it has many more fields that the definition above.",
needs 'that' changed to 'than' and I would insert " following tp_doc" after 'fields'.
History
Date User Action Args
2011-08-15 00:21:28terry.reedysetrecipients: + terry.reedy, eric.araujo, eli.bendersky, docs@python, python-dev, eric.snow
2011-08-15 00:21:28terry.reedysetmessageid: <1313367688.35.0.32127762405.issue12672@psf.upfronthosting.co.za>
2011-08-15 00:21:27terry.reedylinkissue12672 messages
2011-08-15 00:21:27terry.reedycreate