bpo-17045: Improve C-API doc for PyTypeObject. (gh-7413)

The existing doc had a number of info gaps and was a little hard to use.  This patch provides several quick-reference tables as well as examples.

Author: ericsnowcurrently