Javadoc clarifications