Improve the C-API doc for PyTypeObject. This includes adding several quick-
reference tables and a lot of missing slot/typedef entries. The existing
entries were also cleaned up with a slightly more consistent format.