javadoc clarification