--- old/src/java.desktop/share/classes/javax/print/attribute/PrintRequestAttributeSet.java 2017-07-16 16:17:38.000000000 -0700 +++ new/src/java.desktop/share/classes/javax/print/attribute/PrintRequestAttributeSet.java 2017-07-16 16:17:38.000000000 -0700 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -23,88 +23,72 @@ * questions. */ - package javax.print.attribute; /** - * Interface PrintRequestAttributeSet specifies the interface for a set of - * print request attributes, i.e. printing attributes that implement interface - * {@link PrintRequestAttribute PrintRequestAttribute}. - * The client uses a PrintRequestAttributeSet to specify the settings to be - * applied to a whole print job and to all the docs in the print job. - *

- * PrintRequestAttributeSet is just an {@link AttributeSet AttributeSet} whose - * constructors and mutating operations guarantee an additional invariant, - * namely that all attribute values in the PrintRequestAttributeSet must be - * instances of interface {@link PrintRequestAttribute PrintRequestAttribute}. - * The {@link #add(Attribute) add(Attribute)}, and - * {@link #addAll(AttributeSet) addAll(AttributeSet)} operations - * are respecified below to guarantee this additional invariant. + * Interface {@code PrintRequestAttributeSet} specifies the interface for a set + * of print request attributes, i.e. printing attributes that implement + * interface {@link PrintRequestAttribute PrintRequestAttribute}. The client + * uses a {@code PrintRequestAttributeSet} to specify the settings to be applied + * to a whole print job and to all the docs in the print job. + *

+ * {@code PrintRequestAttributeSet} is just an {@link AttributeSet AttributeSet} + * whose constructors and mutating operations guarantee an additional invariant, + * namely that all attribute values in the {@code PrintRequestAttributeSet} must + * be instances of interface + * {@link PrintRequestAttribute PrintRequestAttribute}. The + * {@link #add(Attribute) add(Attribute)}, and + * {@link #addAll(AttributeSet) addAll(AttributeSet)} operations are respecified + * below to guarantee this additional invariant. * - * @author Alan Kaminsky + * @author Alan Kaminsky */ public interface PrintRequestAttributeSet extends AttributeSet { /** * Adds the specified attribute value to this attribute set if it is not - * already present, first removing any existing value in the same - * attribute category as the specified attribute value (optional - * operation). - * - * @param attribute Attribute value to be added to this attribute set. + * already present, first removing any existing value in the same attribute + * category as the specified attribute value (optional operation). * - * @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 PrintRequestAttribute PrintRequestAttribute}. - * @throws NullPointerException - * (unchecked exception) Thrown if the {@code attribute} is null. + * @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 if this attribute set does not support + * the {@code add()} operation + * @throws ClassCastException if the {@code attribute} is not an instance of + * interface {@link PrintRequestAttribute PrintRequestAttribute} + * @throws NullPointerException if the {@code attribute} is {@code 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 union of the two sets. - *

- * The behavior of the {@code addAll()} operation is unspecified if - * the specified set is modified while the operation is in progress. - *

- * 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 PrintRequestAttribute - * PrintRequestAttribute}. - * @throws NullPointerException - * (Unchecked exception) Thrown if the specified set is null. - * + * 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 union of the two sets. + *

+ * The behavior of the {@code addAll()} operation is unspecified if the + * specified set is modified while the operation is in progress. + *

+ * 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 if this attribute set does not support + * the {@code addAll()} method + * @throws ClassCastException if some element in the specified set is not an + * instance of interface + * {@link PrintRequestAttribute PrintRequestAttribute} + * @throws NullPointerException if the specified set is {@code null} * @see #add(Attribute) */ public boolean addAll(AttributeSet attributes); - }