WL-2820 Add javadoc to explain return