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.
