javadoc iterator clarification