src/share/classes/javax/naming/directory/Attribute.java

*** 263,273 ****
       * This method returns the value at the <tt>ix</tt> index of the list of
       * attribute values.
       * If the attribute values are unordered,
       * this method returns the value that happens to be at that index.
       * @param ix The index of the value in the ordered list of attribute values.
!      * 0 <= <tt>ix</tt> < <tt>size()</tt>.
       * @return The possibly null attribute value at index <tt>ix</tt>;
       *   null if the attribute value is null.
       * @exception NamingException If a naming exception was encountered while
       * retrieving the value.
       * @exception IndexOutOfBoundsException If <tt>ix</tt> is outside the specified range.
--- 263,273 ----
       * This method returns the value at the <tt>ix</tt> index of the list of
       * attribute values.
       * If the attribute values are unordered,
       * this method returns the value that happens to be at that index.
       * @param ix The index of the value in the ordered list of attribute values.
!      * {@code 0 <= ix < size()}.
       * @return The possibly null attribute value at index <tt>ix</tt>;
       *   null if the attribute value is null.
       * @exception NamingException If a naming exception was encountered while
       * retrieving the value.
       * @exception IndexOutOfBoundsException If <tt>ix</tt> is outside the specified range.
*** 282,292 ****
       * this method removes the value that happens to be at that index.
       * Values located at indices greater than <tt>ix</tt> are shifted up towards
       * the front of the list (and their indices decremented by one).
       *
       * @param ix The index of the value to remove.
!      * 0 <= <tt>ix</tt> < <tt>size()</tt>.
       * @return The possibly null attribute value at index <tt>ix</tt> that was removed;
       *   null if the attribute value is null.
       * @exception IndexOutOfBoundsException If <tt>ix</tt> is outside the specified range.
       */
      Object remove(int ix);
--- 282,292 ----
       * this method removes the value that happens to be at that index.
       * Values located at indices greater than <tt>ix</tt> are shifted up towards
       * the front of the list (and their indices decremented by one).
       *
       * @param ix The index of the value to remove.
!      * {@code 0 <= ix < size()}.
       * @return The possibly null attribute value at index <tt>ix</tt> that was removed;
       *   null if the attribute value is null.
       * @exception IndexOutOfBoundsException If <tt>ix</tt> is outside the specified range.
       */
      Object remove(int ix);
*** 300,310 ****
       * by one).
       * If the attribute values are unordered and already have <tt>attrVal</tt>,
       * <tt>IllegalStateException</tt> is thrown.
       *
       * @param ix The index in the ordered list of attribute values to add the new value.
!      * 0 <= <tt>ix</tt> <= <tt>size()</tt>.
       * @param attrVal The possibly null attribute value to add; if null, null is
       * the value added.
       * @exception IndexOutOfBoundsException If <tt>ix</tt> is outside the specified range.
       * @exception IllegalStateException If the attribute values are unordered and
       * <tt>attrVal</tt> is one of those values.
--- 300,310 ----
       * by one).
       * If the attribute values are unordered and already have <tt>attrVal</tt>,
       * <tt>IllegalStateException</tt> is thrown.
       *
       * @param ix The index in the ordered list of attribute values to add the new value.
!      * {@code 0 <= ix <= size()}.
       * @param attrVal The possibly null attribute value to add; if null, null is
       * the value added.
       * @exception IndexOutOfBoundsException If <tt>ix</tt> is outside the specified range.
       * @exception IllegalStateException If the attribute values are unordered and
       * <tt>attrVal</tt> is one of those values.
*** 320,330 ****
       * this method sets the value that happens to be at that index
       * to <tt>attrVal</tt>, unless <tt>attrVal</tt> is already one of the values.
       * In that case, <tt>IllegalStateException</tt> is thrown.
       *
       * @param ix The index of the value in the ordered list of attribute values.
!      * 0 <= <tt>ix</tt> < <tt>size()</tt>.
       * @param attrVal The possibly null attribute value to use.
       * If null, 'null' replaces the old value.
       * @return The possibly null attribute value at index ix that was replaced.
       *   Null if the attribute value was null.
       * @exception IndexOutOfBoundsException If <tt>ix</tt> is outside the specified range.
--- 320,330 ----
       * this method sets the value that happens to be at that index
       * to <tt>attrVal</tt>, unless <tt>attrVal</tt> is already one of the values.
       * In that case, <tt>IllegalStateException</tt> is thrown.
       *
       * @param ix The index of the value in the ordered list of attribute values.
!      * {@code 0 <= ix < size()}.
       * @param attrVal The possibly null attribute value to use.
       * If null, 'null' replaces the old value.
       * @return The possibly null attribute value at index ix that was replaced.
       *   Null if the attribute value was null.
       * @exception IndexOutOfBoundsException If <tt>ix</tt> is outside the specified range.