Update javadoc for clarification