[docs] [issue17589] Make documentation about macros in C API explicit about rvalue vs statement

Antoine Pitrou report at bugs.python.org
Sun Mar 31 22:40:45 CEST 2013

Antoine Pitrou added the comment:

Py_INCREF usable as an rvalue sounds more like an accident than a deliberate feature, and it would be IMO counter-productive to codify this behaviour in the docs.

As for the lvalue usage of Py_REFCNT and Py_SIZE, I think it would be better if it were limited to CPython core. But arguably writers of extension types may want to mutate the size field of a varsize object.

nosy: +pitrou

Python tracker <report at bugs.python.org>

More information about the docs mailing list