#720 Updated Javadoc as per review comment