[Python-Dev] Doc strings for typeslots? (original) (raw)

Greg Ewing greg@cosc.canterbury.ac.nz
Wed, 26 Mar 2003 10:49:27 +1200 (NZST)

A Pyrex user recently pointed out to me that trying to give a docstring to an xxx method of an extension type doesn't work.

The reason for this is that the C functions implementing these methods live in slots of the typeobject, and there's apparently nowhere to put docstrings for them.

I'm speculating that this could be worked around by getting the slot's wrapper object out of the type dict after the type is initialised, and stuffing a docstring into it.

This would only work if a new set of wrappers is created for each type, rather than re-using generic ones. An experiment suggests that this is what happens -- can anyone confirm this?

Or, is there a better way of giving these things docstrings that I've missed?

Greg Ewing, Computer Science Dept, +--------------------------------------+ University of Canterbury, | A citizen of NewZealandCorp, a | Christchurch, New Zealand | wholly-owned subsidiary of USA Inc. | greg@cosc.canterbury.ac.nz +--------------------------------------+