>> That tp_doc will be copied is currently undocumented. PyType_FromSpec
>> is documented in the PEP.
> 
> I meant all of py_tp_doc, "limited api", "restricted api" show almost
> zero hits in the API docs. A PEP is nice but I'm not sure many people
> spontaneously read PEPs.

No, there is no documentation in the Doc directory. I *would* expect
that people interested in using the stable ABI do find the PEP and
read it. With the exception of this issue, I consider the PEP to be
complete and correct documentation (of course, it probably contains
errors that I'm unaware of).

However, documentation for the PEP 384 changes seems to be an
unrelated issue.