Summary

Update the specifications of Swing's DefaultListSelectionModel class insertIndexInterval and removeIndexInterval methods to document that they throw IndexOutOfBoundsException when input parameters index or length are negative.

Problem

The insertIndexInterval and removeIndexInterval methods of the DefaultListSelectionModel class throw IndexOutOfBoundsException when their input parameters index or length are negative. However this is not specified.

Solution

Update the spec to document IndexOutOfBoundsException is thrown when input parameters index or length are negative.

Specification

javax.swing.DefaultListSelectionModel

      * at index is itself selected and the selection mode is not
      * SINGLE_SELECTION, set all of the newly inserted items as selected.
      * Otherwise leave them unselected. This method is typically
      * called to sync the selection model with a corresponding change
      * in the data model.
+     *
+     * @throws IndexOutOfBoundsException if either {@code index}
+     *          or {@code length} is negative
      */
     public void insertIndexInterval(int index, int length, boolean before)

       * Remove the indices in the interval index0,index1 (inclusive) from
      * the selection model.  This is typically called to sync the selection
      * model width a corresponding change in the data model.  Note
      * that (as always) index0 need not be <= index1.
+     *
+     * @throws IndexOutOfBoundsException if either index is negative
      */
     public void removeIndexInterval(int index0, int index1)