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