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