More javadoc clarification