But this doesn't answer my question. I still think that the docs and the code disagree. (and also I _hope_ that the docs are correct and the code is wrong ;-)
Fred & I had a little whiteboard session. The docs indeed disagree with the code, and we agree that the code should be fixed. This requires some work: we'll have to introduce a new kind of descriptor that wraps a PyMethodDef pointer and creates a PyCFunction in response to the tp_descr_get call with the type as self. Fred will do this.
--Guido van Rossum (home page: http://www.python.org/~guido/)