Added some return info in api docs.
Merge pull request #2317 from javierav/docsfix

Added some return info in api docs.