http://docs.python.org/dev/c-api/typeobj.html
I found the the documentation for PyTypeObject to be somewhat harder to use than it need be. In the end I distilled the info down for my own use. I'm comfortable with what I came up with, so I'd like to at least add a condensed version of one or two of the tables I made to the top of the doc, with the slot names linking to each description as it currently exists. Attached is a patch.
(I also plan on reformatting the doc source so the lines wrap better--70 columns or so.)
As well, I have a couple open questions that I'll address separately:
* should tp_del be added?
* inheritance of tp_flags...