JavaDoc clarifications