javadoc clarifications
Javadoc clarifications