src/java.desktop/share/classes/javax/print/attribute/DocAttributeSet.java

*** 52,104 ****
       * attribute category as the specified attribute value (optional
       * operation).
       *
       * @param  attribute  Attribute value to be added to this attribute set.
       *
!      * @return  <tt>true</tt> if this attribute set changed as a result of
       *          the call, i.e., the given attribute value was not already a
       *          member of this attribute set.
       *
       * @throws  UnmodifiableSetException
       *     (unchecked exception) Thrown if this attribute set does not
!      *     support the <CODE>add()</CODE> operation.
       * @throws  ClassCastException
!      *     (unchecked exception) Thrown if the <CODE>attribute</CODE> is
       *     not an instance of interface
       *     {@link DocAttribute DocAttribute}.
       * @throws  NullPointerException
!      *    (unchecked exception) Thrown if the <CODE>attribute</CODE> is null.
       */
      public boolean add(Attribute attribute);
  
      /**
       * Adds all of the elements in the specified set to this attribute.
       * The outcome is  the same as if the
       * {@link #add(Attribute) add(Attribute)}
       * operation had been applied to this attribute set successively with
       * each element from the specified set. If none of the categories in the
       * specified set  are the same as any categories in this attribute set,
!      * the <tt>addAll()</tt> operation effectively modifies this attribute
       * set so that its value is the <i>union</i> of the two sets.
       * <P>
!      * The behavior of the <CODE>addAll()</CODE> operation is unspecified if
       * the specified set is modified while the operation is in progress.
       * <P>
!      * If the <CODE>addAll()</CODE> operation throws an exception, the effect
       * on this attribute set's state is implementation dependent; elements
       * from the specified set before the point of the exception may or
       * may not have been added to this attribute set.
       *
       * @param  attributes  whose elements are to be added to this attribute
       *            set.
       *
!      * @return  <tt>true</tt> if this attribute set changed as a result of
       *          the call.
       *
       * @throws  UnmodifiableSetException
       *     (Unchecked exception) Thrown if this attribute set does not
!      *     support the <tt>addAll()</tt> method.
       * @throws  ClassCastException
       *     (Unchecked exception) Thrown if some element in the specified
       *     set is not an instance of interface {@link DocAttribute
       *     DocAttribute}.
       * @throws  NullPointerException
--- 52,104 ----
       * attribute category as the specified attribute value (optional
       * operation).
       *
       * @param  attribute  Attribute value to be added to this attribute set.
       *
!      * @return  {@code true} if this attribute set changed as a result of
       *          the call, i.e., the given attribute value was not already a
       *          member of this attribute set.
       *
       * @throws  UnmodifiableSetException
       *     (unchecked exception) Thrown if this attribute set does not
!      *     support the {@code add()} operation.
       * @throws  ClassCastException
!      *     (unchecked exception) Thrown if the {@code attribute} is
       *     not an instance of interface
       *     {@link DocAttribute DocAttribute}.
       * @throws  NullPointerException
!      *    (unchecked exception) Thrown if the {@code attribute} is null.
       */
      public boolean add(Attribute attribute);
  
      /**
       * Adds all of the elements in the specified set to this attribute.
       * The outcome is  the same as if the
       * {@link #add(Attribute) add(Attribute)}
       * operation had been applied to this attribute set successively with
       * each element from the specified set. If none of the categories in the
       * specified set  are the same as any categories in this attribute set,
!      * the {@code addAll()} operation effectively modifies this attribute
       * set so that its value is the <i>union</i> of the two sets.
       * <P>
!      * The behavior of the {@code addAll()} operation is unspecified if
       * the specified set is modified while the operation is in progress.
       * <P>
!      * If the {@code addAll()} operation throws an exception, the effect
       * on this attribute set's state is implementation dependent; elements
       * from the specified set before the point of the exception may or
       * may not have been added to this attribute set.
       *
       * @param  attributes  whose elements are to be added to this attribute
       *            set.
       *
!      * @return  {@code true} if this attribute set changed as a result of
       *          the call.
       *
       * @throws  UnmodifiableSetException
       *     (Unchecked exception) Thrown if this attribute set does not
!      *     support the {@code addAll()} method.
       * @throws  ClassCastException
       *     (Unchecked exception) Thrown if some element in the specified
       *     set is not an instance of interface {@link DocAttribute
       *     DocAttribute}.
       * @throws  NullPointerException