Here are some improvements for java.util.*List.java javadoc: if list -> if the list Gratuitous variety of semantically identical IndexOutOfBoundsException @throws specifications. Likewise with @throws UnsupportedOperationException First sentence verb form. this collection -> this list this set -> this list AbstractSequentialList.listIterator needs to be documented to throw IndexOutOfBoundsException, as expected by the code, and as implemented by the implementing classes. More use of <tt>foo</tt> would be good. ###@###.### 2005-04-27 03:51:42 GMT
|