[New-bugs-announce] [issue17045] Improve C-API doc for PyTypeObject

[Eric Snow]

New submission from Eric Snow:

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...

----------
files: typeobj-doc.diff
keywords: patch
messages: 180723
nosy: eric.snow
priority: normal
severity: normal
status: open
title: Improve C-API doc for PyTypeObject
Added file: http://bugs.python.org/file28864/typeobj-doc.diff

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue17045>
_______________________________________