Added some return info in api docs.