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

Larry Hastings added the comment: Amaury: I'd appreciate it if you'd bring those examples up on bug 17206. If we're going to change the semantics of Py_INCREF I'd prefer we did it with our eyes wide open. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue17589> _______________________________________