Clarified docblock comments regarding return type and exceptions