Yes, I didn't investigate this a lot, but at least that's the case in the sample code and how they used these APIs in wrt-plugins-tizen module.

I agree with your opinion on Tizen API document, however I think at least their code base are verified in several iterations, so I borrowed the code style of how they called those APIs.