Some javadoc clarifications.