That info needs to be in the manual. Also, the return value for an operation is critical for understanding what it does. The API summaries elide the return value, and make it difficult to understand the function fully. It's worth the extra screen real estate to specify the return value in all the API summaries.