Updated javadoc for iterator() method to include semantics regarding listeners