[issue8946] PyBuffer_Release signature in 3.1 documentation is incorrect

[Kristján Valur Jónsson]

Kristján Valur Jónsson <kristjan at ccpgames.com> added the comment:

The documentation issue appears present in 2.7 (and 2.6).
Further, the Py_buffer member 'obj' is undocumented, and the in-line comment in object.h falsely states that it is a "borrowed" reference, whereas PyBuffer_Release() Py_XDECREFs it and clears it.  Thus, it is also safe to call PyBuffer_Release() more than once, something that can be useful for certain error scenarios.

PEP 3118 also has not been updated to reflect the above.

----------
nosy: +krisvale

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