jdk-sandbox: comparison jdk/src/java.desktop/share/classes/javax/print/attribute/AttributeSet.java

equal deleted inserted replaced

-:9c9ff2c42e0d
+:1a96ab120a48
 public interface AttributeSet {
 /**
 * Returns the attribute value which this attribute set contains in the
-* given attribute category. Returns <tt>null</tt> if this attribute set
+* given attribute category. Returns {@code null} if this attribute set
 * does not contain any attribute value in the given attribute category.
 *
 * @param  category  Attribute category whose associated attribute value
 *                   is to be returned. It must be a
 *                   {@link java.lang.Class Class}
 *                   that implements interface {@link Attribute
 *                   Attribute}.
 *
 * @return  The attribute value in the given attribute category contained
-*          in this attribute set, or <tt>null</tt> if this attribute set
+*          in this attribute set, or {@code null} if this attribute set
 *          does not contain any attribute value in the given attribute
 *          category.
 *
 * @throws  NullPointerException
-*     (unchecked exception) Thrown if the <CODE>category</CODE> is null.
+*     (unchecked exception) Thrown if the {@code category} is null.
 * @throws  ClassCastException
-*     (unchecked exception) Thrown if the <CODE>category</CODE> is not a
+*     (unchecked exception) Thrown if the {@code category} is not a
 *     {@link java.lang.Class Class} that implements interface {@link
 *     Attribute Attribute}.
 */
 public Attribute get(Class<?> category);
 * already present, first removing any existing value in the same
 * attribute category as the specified attribute value.
 *
 * @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
+* @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  NullPointerException
-*     (unchecked exception) Thrown if the <CODE>attribute</CODE> is null.
+*     (unchecked exception) Thrown if the {@code attribute} is null.
 * @throws  UnmodifiableSetException
 *     (unchecked exception) Thrown if this attribute set does not support
-*     the <CODE>add()</CODE> operation.
+*     the {@code add()} operation.
 */
 public boolean add(Attribute attribute);
 /**
 * Removes any attribute for this category from this attribute set if
-* present. If <CODE>category</CODE> is null, then
+* present. If {@code category} is null, then
-* <CODE>remove()</CODE> does nothing and returns <tt>false</tt>.
+* {@code remove()} does nothing and returns {@code false}.
 *
 * @param  category Attribute category to be removed from this
 *                  attribute set.
 *
-* @return  <tt>true</tt> if this attribute set changed as a result of the
+* @return  {@code true} if this attribute set changed as a result of the
 *         call, i.e., the given attribute value had been a member of this
 *          attribute set.
 *
 * @throws  UnmodifiableSetException
 *     (unchecked exception) Thrown if this attribute set does not support
-*     the <CODE>remove()</CODE> operation.
+*     the {@code remove()} operation.
 */
 public boolean remove(Class<?> category);
 /**
 * Removes the specified attribute from this attribute set if
-* present. If <CODE>attribute</CODE> is null, then
+* present. If {@code attribute} is null, then
-* <CODE>remove()</CODE> does nothing and returns <tt>false</tt>.
+* {@code remove()} does nothing and returns {@code false}.
 *
 * @param  attribute Attribute value to be removed from this attribute set.
 *
-* @return  <tt>true</tt> if this attribute set changed as a result of the
+* @return  {@code true} if this attribute set changed as a result of the
 *         call, i.e., the given attribute value had been a member of this
 *          attribute set.
 *
 * @throws  UnmodifiableSetException
 *     (unchecked exception) Thrown if this attribute set does not support
-*     the <CODE>remove()</CODE> operation.
+*     the {@code remove()} operation.
 */
 public boolean remove(Attribute attribute);
 /**
-* Returns <tt>true</tt> if this attribute set contains an
+* Returns {@code true} if this attribute set contains an
 * attribute for the specified category.
 *
 * @param  category whose presence in this attribute set is
 *            to be tested.
 *
-* @return  <tt>true</tt> if this attribute set contains an attribute
+* @return  {@code true} if this attribute set contains an attribute
 *         value for the specified category.
 */
 public boolean containsKey(Class<?> category);
 /**
-* Returns <tt>true</tt> if this attribute set contains the given
+* Returns {@code true} if this attribute set contains the given
 * attribute value.
 *
 * @param  attribute  Attribute value whose presence in this
 * attribute set is to be tested.
 *
-* @return  <tt>true</tt> if this attribute set contains the given
+* @return  {@code true} if this attribute set contains the given
 *      attribute  value.
 */
 public boolean containsValue(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.
-* The behavior of the <CODE>addAll(AttributeSet)</CODE>
+* The behavior of the {@code addAll(AttributeSet)}
 * operation is unspecified if the specified set is modified while
 * the operation is in progress.
 * <P>
-* If the <CODE>addAll(AttributeSet)</CODE> operation throws an exception,
+* If the {@code addAll(AttributeSet)} 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
+* @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 <tt>addAll(AttributeSet)</tt> method.
+*     the {@code addAll(AttributeSet)} method.
 * @throws  NullPointerException
 *     (Unchecked exception) Thrown if some element in the specified
 *     set is null.
 *
 * @see #add(Attribute)
 */
 public boolean addAll(AttributeSet attributes);
 /**
 * Returns the number of attributes in this attribute set. If this
-* attribute set contains more than <tt>Integer.MAX_VALUE</tt> elements,
+* attribute set contains more than {@code Integer.MAX_VALUE} elements,
-* returns  <tt>Integer.MAX_VALUE</tt>.
+* returns  {@code Integer.MAX_VALUE}.
 *
 * @return  The number of attributes in this attribute set.
 */
 public int size();
 /**
 * Removes all attributes from this attribute set.
 *
 * @throws  UnmodifiableSetException
 *   (unchecked exception) Thrown if this attribute set does not support
-*     the <CODE>clear()</CODE> operation.
+*     the {@code clear()} operation.
 */
 public void clear();
 /**
 * Returns true if this attribute set contains no attributes.
 */
 public boolean isEmpty();
 /**
 * Compares the specified object with this attribute set for equality.
-* Returns <tt>true</tt> if the given object is also an attribute set and
+* Returns {@code true} if the given object is also an attribute set and
 * the two attribute sets contain the same attribute category-attribute
 * value mappings. This ensures that the
-* <tt>equals()</tt> method works properly across different
+* {@code equals()} method works properly across different
 * implementations of the AttributeSet interface.
 *
 * @param  object to be compared for equality with this attribute set.
 *
-* @return  <tt>true</tt> if the specified object is equal to this
+* @return  {@code true} if the specified object is equal to this
 *       attribute   set.
 */
 public boolean equals(Object object);
 /**
 * Returns the hash code value for this attribute set. The hash code of an
 * attribute set is defined to be the sum of the hash codes of each entry
 * in the AttributeSet.
-* This ensures that <tt>t1.equals(t2)</tt> implies that
+* This ensures that {@code t1.equals(t2)} implies that
-* <tt>t1.hashCode()==t2.hashCode()</tt> for any two attribute sets
+* {@code t1.hashCode()==t2.hashCode()} for any two attribute sets
-* <tt>t1</tt> and <tt>t2</tt>, as required by the general contract of
+* {@code t1} and {@code t2}, as required by the general contract of
 * {@link java.lang.Object#hashCode() Object.hashCode()}.
 *
 * @return  The hash code value for this attribute set.
 */
 public int hashCode();

changeset 32283	1a96ab120a48
parent 25859	3317bb8137f4
child 47196	a3211bb4daff