The constructor for ListSelectionEvent documents the fact
that firstIndex <= lastIndex. The getFirstIndex(), getLastIndex()
methods' javadoc doesn't mention this. Since most developers
aren't creating ListSelectionEvents, they're just dealing with
them, it would be helpful to advertise the firstIndex <= lastIndex
inequality in the methods' javadoc.

Also: this is the javadoc for valueIsAdjusting:

   Returns true if this is one of multiple change events.

   Returns:
       true if this is one of a rapid series of events

It doesn't seem seem sensible for the @returns text to be slightly
different than the main javadoc ("rapid")? It would be useful to
point out that typcially (at least), isAdjusting is true in the
middle of a selection change that's tracking a series of mouse-dragged
events.