*
* Example: - *
+ * {@code
* DocFlavor flavor = DocFlavor.INPUT_STREAM.POSTSCRIPT;
* PrintRequestAttributeSet aset = new HashPrintRequestAttributeSet();
* aset.add(MediaSizeName.ISO_A4);
@@ -56,7 +56,7 @@ import javax.print.event.PrintServiceAttributeListener;
* } catch (PrintException e) {
* }
* }
- *
+ * }
*/
public interface PrintService {
diff --git a/src/share/classes/javax/print/ServiceUI.java b/src/share/classes/javax/print/ServiceUI.java
index 7a9dee8c411c860479ecf4f6e921021bd7c8a7f2..38439cc27a6884b54fae9b4463f5c75af1b3c80e 100644
--- a/src/share/classes/javax/print/ServiceUI.java
+++ b/src/share/classes/javax/print/ServiceUI.java
@@ -118,7 +118,7 @@ public class ServiceUI {
* any changes made by the user.
*
* A typical basic usage of this method may be :
- *
+ * {@code
* PrintService[] services = PrintServiceLookup.lookupPrintServices(
* DocFlavor.INPUT_STREAM.JPEG, null);
* PrintRequestAttributeSet attributes = new HashPrintRequestAttributeSet();
@@ -131,7 +131,7 @@ public class ServiceUI {
* ... print ...
* }
* }
- *
+ * }
* * @param gc used to select screen. null means primary or default screen. diff --git a/src/share/classes/javax/print/ServiceUIFactory.java b/src/share/classes/javax/print/ServiceUIFactory.java index 820acfa1cdd2a2466f7cfe6f47045473fd7b7f6d..e8cd0675ace60d30583a79e7b1c27f4ed16bb4fd 100644 --- a/src/share/classes/javax/print/ServiceUIFactory.java +++ b/src/share/classes/javax/print/ServiceUIFactory.java @@ -39,8 +39,8 @@ package javax.print; * initialize services only when needed without any API dependencies * except in an environment in which they are used. *
- * Swing UIs are preferred as they provide a more consistent L&F and - * can support accessibility APIs. + * Swing UIs are preferred as they provide a more consistent {@literal L&F} + * and can support accessibility APIs. *
* Example usage: *
diff --git a/src/share/classes/javax/print/attribute/AttributeSet.java b/src/share/classes/javax/print/attribute/AttributeSet.java
index a00d4789cf59ee1c879d561a3b3f3bc4b8f5f50a..0f90dbdeacd196df15d918f2be8f1881ff7cf47c 100644
--- a/src/share/classes/javax/print/attribute/AttributeSet.java
+++ b/src/share/classes/javax/print/attribute/AttributeSet.java
@@ -42,7 +42,7 @@ package javax.print.attribute;
* class rather than the attribute object's class itself. An attribute
* object's
* category is determined by calling the {@link Attribute#getCategory()
- * getCategory()} method defined in interface {@link Attribute
+ * getCategory()} method defined in interface {@link Attribute
* Attribute}.
*
* The interfaces of an AttributeSet resemble those of the Java Collections
@@ -217,7 +217,7 @@ public interface AttributeSet {
/**
* 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)}
+ * {@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 addAll(AttributeSet)
@@ -301,7 +301,7 @@ public interface AttributeSet {
* This ensures that t1.equals(t2) implies that
* t1.hashCode()==t2.hashCode() for any two attribute sets
* t1 and t2, as required by the general contract of
- * {@link java.lang.Object#hashCode() Object.hashCode()}.
+ * {@link java.lang.Object#hashCode() Object.hashCode()}.
*
* @return The hash code value for this attribute set.
*/
diff --git a/src/share/classes/javax/print/attribute/DateTimeSyntax.java b/src/share/classes/javax/print/attribute/DateTimeSyntax.java
index a552436ef979e88b2039d8312346baa8adee270c..175281c07bfd330b5806a3b5be08b92c7dc4453e 100644
--- a/src/share/classes/javax/print/attribute/DateTimeSyntax.java
+++ b/src/share/classes/javax/print/attribute/DateTimeSyntax.java
@@ -36,9 +36,9 @@ import java.util.Date;
*
* Under the hood, a date-time attribute is stored as a value of class
* java.util.Date. You can get a date-time attribute's Date value by
- * calling {@link #getValue() getValue()}. A date-time attribute's
+ * calling {@link #getValue() getValue()}. A date-time attribute's
* Date value is established when it is constructed (see {@link
- * #DateTimeSyntax(Date) DateTimeSyntax(Date)}). Once
+ * #DateTimeSyntax(Date) DateTimeSyntax(Date)}). Once
* constructed, a date-time attribute's value is immutable.
*
* To construct a date-time attribute from separate values of the year, month,
diff --git a/src/share/classes/javax/print/attribute/DocAttributeSet.java b/src/share/classes/javax/print/attribute/DocAttributeSet.java
index 7091a0cd92c95b2b2a4afd68622183df154c47c4..4cb3d413ca98e16b2b36852ff97ba354b3afd088 100644
--- a/src/share/classes/javax/print/attribute/DocAttributeSet.java
+++ b/src/share/classes/javax/print/attribute/DocAttributeSet.java
@@ -37,8 +37,8 @@ package javax.print.attribute;
* constructors and mutating operations guarantee an additional invariant,
* namely that all attribute values in the DocAttributeSet must be instances
* of interface {@link DocAttribute DocAttribute}.
- * The {@link #add(Attribute) add(Attribute)}, and
- * {@link #addAll(AttributeSet) addAll(AttributeSet)} operations
+ * The {@link #add(Attribute) add(Attribute)}, and
+ * {@link #addAll(AttributeSet) addAll(AttributeSet)} operations
* are respecified below to guarantee this additional invariant.
*
*
@@ -74,7 +74,7 @@ public interface DocAttributeSet extends AttributeSet {
/**
* 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)}
+ * {@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,
diff --git a/src/share/classes/javax/print/attribute/EnumSyntax.java b/src/share/classes/javax/print/attribute/EnumSyntax.java
index f1dbf8249e6d94ccd84fa0bbc9f31cc411f28f76..9847004b36e5a60a672a04784103ddb19f5e70df 100644
--- a/src/share/classes/javax/print/attribute/EnumSyntax.java
+++ b/src/share/classes/javax/print/attribute/EnumSyntax.java
@@ -81,15 +81,15 @@ import java.io.Serializable;
* for identical objects (==).
*
* You can convert an enumeration value to a string by calling {@link
- * #toString() toString()}. The string is obtained from a table
+ * #toString() toString()}. The string is obtained from a table
* supplied by the enumeration class.
*
* Under the hood, an enumeration value is just an integer, a different integer
* for each enumeration value within an enumeration class. You can get an
* enumeration value's integer value by calling {@link #getValue()
- * getValue()}. An enumeration value's integer value is established
+ * getValue()}. An enumeration value's integer value is established
* when it is constructed (see {@link #EnumSyntax(int)
- * EnumSyntax(int)}). Since the constructor is protected, the only
+ * EnumSyntax(int)}). Since the constructor is protected, the only
* possible enumeration values are the singleton objects declared in the
* enumeration class; additional enumeration values cannot be created at run
* time.
@@ -170,10 +170,10 @@ public abstract class EnumSyntax implements Serializable, Cloneable {
*
* @return The enumeration singleton value stored at index
* i-L in the enumeration value table returned by
- * {@link #getEnumValueTable() getEnumValueTable()},
+ * {@link #getEnumValueTable() getEnumValueTable()},
* where i is this enumeration value's integer value and
* L is the value returned by {@link #getOffset()
- * getOffset()}.
+ * getOffset()}.
*
* @throws ObjectStreamException if the stream can't be deserialised
* @throws InvalidObjectException
@@ -220,18 +220,18 @@ public abstract class EnumSyntax implements Serializable, Cloneable {
* Returns the string table for this enumeration value's enumeration class.
* The enumeration class's integer values are assumed to lie in the range
* L..L+N-1, where L is the value returned by
- * {@link #getOffset() getOffset()} and N is the length
+ * {@link #getOffset() getOffset()} and N is the length
* of the string table. The element in the string table at index
* i-L is the value returned by {@link #toString()
- * toString()} for the enumeration value whose integer value
+ * toString()} for the enumeration value whose integer value
* is i. If an integer within the above range is not used by any
* enumeration value, leave the corresponding table element null.
*
* The default implementation returns null. If the enumeration class (a
* subclass of class EnumSyntax) does not override this method to return a
* non-null string table, and the subclass does not override the {@link
- * #toString() toString()} method, the base class {@link
- * #toString() toString()} method will return just a string
+ * #toString() toString()} method, the base class {@link
+ * #toString() toString()} method will return just a string
* representation of this enumeration value's integer value.
* @return the string table
*/
@@ -243,11 +243,11 @@ public abstract class EnumSyntax implements Serializable, Cloneable {
* Returns the enumeration value table for this enumeration value's
* enumeration class. The enumeration class's integer values are assumed to
* lie in the range L..L+N-1, where L is the
- * value returned by {@link #getOffset() getOffset()} and
+ * value returned by {@link #getOffset() getOffset()} and
* N is the length of the enumeration value table. The element in the
* enumeration value table at index i-L is the enumeration
* value object whose integer value is i; the {@link #readResolve()
- * readResolve()} method needs this to preserve singleton
+ * readResolve()} method needs this to preserve singleton
* semantics during deserialization of an enumeration instance. If an
* integer within the above range is not used by any enumeration value,
* leave the corresponding table element null.
@@ -255,8 +255,8 @@ public abstract class EnumSyntax implements Serializable, Cloneable {
* The default implementation returns null. If the enumeration class (a
* subclass of class EnumSyntax) does not override this method to return
* a non-null enumeration value table, and the subclass does not override
- * the {@link #readResolve() readResolve()} method, the base
- * class {@link #readResolve() readResolve()} method will throw
+ * the {@link #readResolve() readResolve()} method, the base
+ * class {@link #readResolve() readResolve()} method will throw
* an exception whenever an enumeration instance is deserialized from an
* object input stream.
* @return the value table
diff --git a/src/share/classes/javax/print/attribute/HashAttributeSet.java b/src/share/classes/javax/print/attribute/HashAttributeSet.java
index e3ab3db11f1af159e023c72c8f27e917d4c1ee7d..f8d9aa992983d65cf0ec904b0a666bf99f76d8bd 100644
--- a/src/share/classes/javax/print/attribute/HashAttributeSet.java
+++ b/src/share/classes/javax/print/attribute/HashAttributeSet.java
@@ -388,7 +388,7 @@ public class HashAttributeSet implements AttributeSet, Serializable {
/**
* 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)}
+ * {@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 addAll(AttributeSet)
@@ -512,7 +512,7 @@ public class HashAttributeSet implements AttributeSet, Serializable {
* This ensures that t1.equals(t2) implies that
* t1.hashCode()==t2.hashCode() for any two attribute sets
* t1 and t2, as required by the general contract of
- * {@link java.lang.Object#hashCode() Object.hashCode()}.
+ * {@link java.lang.Object#hashCode() Object.hashCode()}.
*
* @return The hash code value for this attribute set.
*/
diff --git a/src/share/classes/javax/print/attribute/IntegerSyntax.java b/src/share/classes/javax/print/attribute/IntegerSyntax.java
index 95463e69f8b61425600687aaf8048a83a4eb5904..81ffff90f8673820c635f35900a727d7810233d1 100644
--- a/src/share/classes/javax/print/attribute/IntegerSyntax.java
+++ b/src/share/classes/javax/print/attribute/IntegerSyntax.java
@@ -33,9 +33,9 @@ import java.io.Serializable;
*
* Under the hood, an integer attribute is just an integer. You can get an
* integer attribute's integer value by calling {@link #getValue()
- * getValue()}. An integer attribute's integer value is
+ * getValue()}. An integer attribute's integer value is
* established when it is constructed (see {@link #IntegerSyntax(int)
- * IntegerSyntax(int)}). Once constructed, an integer attribute's
+ * IntegerSyntax(int)}). Once constructed, an integer attribute's
* value is immutable.
*
*
diff --git a/src/share/classes/javax/print/attribute/PrintJobAttributeSet.java b/src/share/classes/javax/print/attribute/PrintJobAttributeSet.java
index fba253b73da748569773914388a4401a07897ea6..e81511f71ebee616d3139b580c14bd75a383c3b6 100644
--- a/src/share/classes/javax/print/attribute/PrintJobAttributeSet.java
+++ b/src/share/classes/javax/print/attribute/PrintJobAttributeSet.java
@@ -36,8 +36,8 @@ package javax.print.attribute;
* constructors and mutating operations guarantee an additional invariant,
* namely that all attribute values in the PrintJobAttributeSet must be
* instances of interface {@link PrintJobAttribute PrintJobAttribute}.
- * The {@link #add(Attribute) add(Attribute)}, and
- * {@link #addAll(AttributeSet) addAll(AttributeSet)} operations
+ * The {@link #add(Attribute) add(Attribute)}, and
+ * {@link #addAll(AttributeSet) >addAll(AttributeSet)} operations
* are respecified below to guarantee this additional invariant.
*
*
@@ -72,7 +72,7 @@ public interface PrintJobAttributeSet extends AttributeSet {
/**
* 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)}
+ * {@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,
diff --git a/src/share/classes/javax/print/attribute/PrintRequestAttributeSet.java b/src/share/classes/javax/print/attribute/PrintRequestAttributeSet.java
index dc78f25a2dbf3470d63ee1f6f08f70ca7a03f75f..6f4c285563f17940a16e040f813a3707d7d527e7 100644
--- a/src/share/classes/javax/print/attribute/PrintRequestAttributeSet.java
+++ b/src/share/classes/javax/print/attribute/PrintRequestAttributeSet.java
@@ -37,8 +37,8 @@ package javax.print.attribute;
* 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
+ * The {@link #add(Attribute) add(Attribute)}, and
+ * {@link #addAll(AttributeSet) addAll(AttributeSet)} operations
* are respecified below to guarantee this additional invariant.
*
*
@@ -73,7 +73,7 @@ public interface PrintRequestAttributeSet extends AttributeSet {
/**
* 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)}
+ * {@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,
diff --git a/src/share/classes/javax/print/attribute/PrintServiceAttributeSet.java b/src/share/classes/javax/print/attribute/PrintServiceAttributeSet.java
index 164f2d310b14eaddb04722da513f598defccb642..f7c111c92751d097d87fe751b3553520117748b5 100644
--- a/src/share/classes/javax/print/attribute/PrintServiceAttributeSet.java
+++ b/src/share/classes/javax/print/attribute/PrintServiceAttributeSet.java
@@ -39,8 +39,8 @@ package javax.print.attribute;
* invariant,
* namely that all attribute values in the PrintServiceAttributeSet must be
* instances of interface {@link PrintServiceAttribute PrintServiceAttribute}.
- * The {@link #add(Attribute) add(Attribute)}, and
- * {@link #addAll(AttributeSet) addAll(AttributeSet)} operations
+ * The {@link #add(Attribute) add(Attribute)}, and
+ * {@link #addAll(AttributeSet) addAll(AttributeSet)} operations
* are respecified below to guarantee this additional invariant.
*
*
@@ -77,7 +77,7 @@ public interface PrintServiceAttributeSet extends AttributeSet {
/**
* 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)}
+ * {@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,
diff --git a/src/share/classes/javax/print/attribute/ResolutionSyntax.java b/src/share/classes/javax/print/attribute/ResolutionSyntax.java
index 5b8ca2c81940b5a6be1244a27b4695eadc7ac04d..a4a103a438d87739a3269f82dcce00968ab12c57 100644
--- a/src/share/classes/javax/print/attribute/ResolutionSyntax.java
+++ b/src/share/classes/javax/print/attribute/ResolutionSyntax.java
@@ -39,7 +39,7 @@ import java.io.Serializable;
* resolution attribute's values, indicating the units in which the values are
* to be returned. The two most common resolution units are dots per inch (dpi)
* and dots per centimeter (dpcm), and exported constants {@link #DPI
- * DPI} and {@link #DPCM DPCM} are provided for
+ * DPI} and {@link #DPCM DPCM} are provided for
* indicating those units.
*
* Once constructed, a resolution attribute's value is immutable.
@@ -68,9 +68,9 @@ import java.io.Serializable;
* done, which would not be guaranteed if a floating point representation were
* used.
*
- * The exported constant {@link #DPI DPI} is actually the
+ * The exported constant {@link #DPI DPI} is actually the
* conversion factor by which to multiply a value in dpi to get the value in
- * dphi. Likewise, the exported constant {@link #DPCM DPCM} is the
+ * dphi. Likewise, the exported constant {@link #DPCM DPCM} is the
* conversion factor by which to multiply a value in dpcm to get the value in
* dphi. A client can specify a resolution value in units other than dpi or dpcm
* by supplying its own conversion factor. However, since the internal units of
@@ -120,12 +120,12 @@ public abstract class ResolutionSyntax implements Serializable, Cloneable {
* @param feedResolution
* Feed direction resolution.
* @param units
- * Unit conversion factor, e.g. {@link #DPI DPI} or
- * {@link #DPCM DPCM}.
+ * Unit conversion factor, e.g. {@link #DPI DPI} or
+ * {@link #DPCM DPCM}.
*
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if crossFeedResolution <
- * 1 or feedResolution < 1 or units < 1.
+ * (unchecked exception) Thrown if {@code crossFeedResolution < 1}
+ * or {@code feedResolution < 1} or {@code units < 1}.
*/
public ResolutionSyntax(int crossFeedResolution, int feedResolution,
int units) {
@@ -172,14 +172,14 @@ public abstract class ResolutionSyntax implements Serializable, Cloneable {
* The values are rounded to the nearest integer.
*
* @param units
- * Unit conversion factor, e.g. {@link #DPI DPI} or
- * {@link #DPCM DPCM}.
+ * Unit conversion factor, e.g. {@link #DPI DPI} or
+ * {@link #DPCM DPCM}.
*
* @return A two-element array with the cross feed direction resolution
* at index 0 and the feed direction resolution at index 1.
*
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if units < 1.
+ * (unchecked exception) Thrown if {@code units < 1}.
*/
public int[] getResolution(int units) {
return new int[] { getCrossFeedResolution(units),
@@ -192,13 +192,13 @@ public abstract class ResolutionSyntax implements Serializable, Cloneable {
* the given units. The value is rounded to the nearest integer.
*
* @param units
- * Unit conversion factor, e.g. {@link #DPI DPI} or
- * {@link #DPCM DPCM}.
+ * Unit conversion factor, e.g. {@link #DPI DPI} or
+ * {@link #DPCM DPCM}.
*
* @return Cross feed direction resolution.
*
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if units < 1.
+ * (unchecked exception) Thrown if {@code units < 1}.
*/
public int getCrossFeedResolution(int units) {
return convertFromDphi (crossFeedResolution, units);
@@ -209,13 +209,13 @@ public abstract class ResolutionSyntax implements Serializable, Cloneable {
* given units. The value is rounded to the nearest integer.
*
* @param units
- * Unit conversion factor, e.g. {@link #DPI DPI} or {@link
- * #DPCM DPCM}.
+ * Unit conversion factor, e.g. {@link #DPI DPI} or {@link
+ * #DPCM DPCM}.
*
* @return Feed direction resolution.
*
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if units < 1.
+ * (unchecked exception) Thrown if {@code units < 1}.
*/
public int getFeedResolution(int units) {
return convertFromDphi (feedResolution, units);
@@ -229,8 +229,8 @@ public abstract class ResolutionSyntax implements Serializable, Cloneable {
* rounded to the nearest integer.
*
* @param units
- * Unit conversion factor, e.g. {@link #DPI DPI} or {@link
- * #DPCM DPCM}.
+ * Unit conversion factor, e.g. {@link #DPI CODE>DPI} or {@link
+ * #DPCM DPCM}.
* @param unitsName
* Units name string, e.g. "dpi" or "dpcm". If
* null, no units name is appended to the result.
@@ -238,7 +238,7 @@ public abstract class ResolutionSyntax implements Serializable, Cloneable {
* @return String version of this resolution attribute.
*
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if units < 1.
+ * (unchecked exception) Thrown if {@code units < 1}.
*/
public String toString(int units, String unitsName) {
StringBuffer result = new StringBuffer();
diff --git a/src/share/classes/javax/print/attribute/Size2DSyntax.java b/src/share/classes/javax/print/attribute/Size2DSyntax.java
index f1f590a2452b6e09ff98f22b91274c6f4d06265a..e8b43a6a5e7c6ef4608bedf7bb7985a54f4fbc81 100644
--- a/src/share/classes/javax/print/attribute/Size2DSyntax.java
+++ b/src/share/classes/javax/print/attribute/Size2DSyntax.java
@@ -38,8 +38,8 @@ import java.io.Serializable;
* values are measured. Methods are provided to return a two-dimensional size
* attribute's values, indicating the units in which the values are to be
* returned. The two most common size units are inches (in) and millimeters
- * (mm), and exported constants {@link #INCH INCH} and {@link #MM
- * MM} are provided for indicating those units.
+ * (mm), and exported constants {@link #INCH INCH} and {@link #MM
+ * MM} are provided for indicating those units.
*
* Once constructed, a two-dimensional size attribute's value is immutable.
*
@@ -66,9 +66,9 @@ import java.io.Serializable;
* units, you have to search for a media size of 215.9 x 279.4 mm; rounding off
* to an integral 216 x 279 mm will not match.
*
- * The exported constant {@link #INCH INCH} is actually the
+ * The exported constant {@link #INCH INCH} is actually the
* conversion factor by which to multiply a value in inches to get the value in
- * µm. Likewise, the exported constant {@link #MM MM} is the
+ * µm. Likewise, the exported constant {@link #MM MM} is the
* conversion factor by which to multiply a value in mm to get the value in
* µm. A client can specify a resolution value in units other than inches
* or mm by supplying its own conversion factor. However, since the internal
@@ -117,12 +117,12 @@ public abstract class Size2DSyntax implements Serializable, Cloneable {
* @param x X dimension.
* @param y Y dimension.
* @param units
- * Unit conversion factor, e.g. {@link #INCH INCH} or
- * {@link #MM MM}.
+ * Unit conversion factor, e.g. {@link #INCH INCH} or
+ * {@link #MM MM}.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if x < 0 or y
- * < 0 or units < 1.
+ * (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0} or
+ * {@code units < 1}.
*/
protected Size2DSyntax(float x, float y, int units) {
if (x < 0.0f) {
@@ -145,12 +145,12 @@ public abstract class Size2DSyntax implements Serializable, Cloneable {
* @param x X dimension.
* @param y Y dimension.
* @param units
- * Unit conversion factor, e.g. {@link #INCH INCH} or
- * {@link #MM MM}.
+ * Unit conversion factor, e.g. {@link #INCH INCH} or
+ * {@link #MM MM}.
*
* @exception IllegalArgumentException
- * (Unchecked exception) Thrown if x < 0 or y
- * < 0 or units < 1.
+ * (Unchecked exception) Thrown if {@code x < 0} or {@code y < 0}
+ * or {@code units < 1}.
*/
protected Size2DSyntax(int x, int y, int units) {
if (x < 0) {
@@ -193,14 +193,13 @@ public abstract class Size2DSyntax implements Serializable, Cloneable {
* as floating-point values.
*
* @param units
- * Unit conversion factor, e.g. {@link #INCH INCH} or
- * {@link #MM MM}.
+ * Unit conversion factor, e.g. {@link #INCH INCH} or {@link #MM MM}.
*
* @return A two-element array with the X dimension at index 0 and the Y
* dimension at index 1.
*
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if units < 1.
+ * (unchecked exception) Thrown if {@code units < 1}.
*/
public float[] getSize(int units) {
return new float[] {getX(units), getY(units)};
@@ -211,13 +210,12 @@ public abstract class Size2DSyntax implements Serializable, Cloneable {
* units as a floating-point value.
*
* @param units
- * Unit conversion factor, e.g. {@link #INCH INCH} or
- * {@link #MM MM}.
+ * Unit conversion factor, e.g. {@link #INCH INCH} or {@link #MM MM}.
*
* @return X dimension.
*
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if units < 1.
+ * (unchecked exception) Thrown if {@code units < 1}.
*/
public float getX(int units) {
return convertFromMicrometers(x, units);
@@ -228,13 +226,12 @@ public abstract class Size2DSyntax implements Serializable, Cloneable {
* units as a floating-point value.
*
* @param units
- * Unit conversion factor, e.g. {@link #INCH INCH} or
- * {@link #MM MM}.
+ * Unit conversion factor, e.g. {@link #INCH INCH} or {@link #MM MM}.
*
* @return Y dimension.
*
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if units < 1.
+ * (unchecked exception) Thrown if {@code units < 1}.
*/
public float getY(int units) {
return convertFromMicrometers(y, units);
@@ -248,16 +245,16 @@ public abstract class Size2DSyntax implements Serializable, Cloneable {
* floating point.
*
* @param units
- * Unit conversion factor, e.g. {@link #INCH INCH} or
- * {@link #MM MM}.
+ * Unit conversion factor, e.g. {@link #INCH INCH} or {@link #MM MM}.
+ *
* @param unitsName
- * Units name string, e.g. "in" or "mm". If
+ * Units name string, e.g. {@code in} or {@code mm}. If
* null, no units name is appended to the result.
*
* @return String version of this two-dimensional size attribute.
*
* @exception IllegalArgumentException
- * (unchecked exception) Thrown if units < 1.
+ * (unchecked exception) Thrown if {@code units < 1}.
*/
public String toString(int units, String unitsName) {
StringBuffer result = new StringBuffer();
diff --git a/src/share/classes/javax/print/attribute/standard/Chromaticity.java b/src/share/classes/javax/print/attribute/standard/Chromaticity.java
index a605c9cf6998fee18cc92b185d5a33129b3fe556..8e29e972b36bdcd7ef82dd23dc1aa18896840412 100644
--- a/src/share/classes/javax/print/attribute/standard/Chromaticity.java
+++ b/src/share/classes/javax/print/attribute/standard/Chromaticity.java
@@ -40,11 +40,11 @@ import javax.print.attribute.PrintJobAttribute;
* can be verified to support color printing.
*
* The table below shows the effects of specifying a Chromaticity attribute of
- * {@link #MONOCHROME MONOCHROME} or {@link #COLOR
- * COLOR} for a monochrome or color document.
+ * {@link #MONOCHROME MONOCHROME} or {@link #COLOR COLOR}
+ * for a monochrome or color document.
*
*
|
* Chromaticity Attribute * |
@@ -57,7 +57,7 @@ import javax.print.attribute.PrintJobAttribute;
* |||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
- * {@link #MONOCHROME MONOCHROME}
+ * {@link #MONOCHROME MONOCHROME}
* |
* * Printed as is, in monochrome @@ -68,7 +68,7 @@ import javax.print.attribute.PrintJobAttribute; * | ||||||||||||||||||
- * {@link #COLOR COLOR}
+ * {@link #COLOR COLOR}
* |
*
* Printed as is, in monochrome
diff --git a/src/share/classes/javax/print/attribute/standard/Compression.java b/src/share/classes/javax/print/attribute/standard/Compression.java
index 19c94b45f4ec429edffeea23f5a94a75393be0d6..5679a73f8502529e94647d3ea20ed325b92f1253 100644
--- a/src/share/classes/javax/print/attribute/standard/Compression.java
+++ b/src/share/classes/javax/print/attribute/standard/Compression.java
@@ -34,7 +34,7 @@ import javax.print.attribute.DocAttribute;
* print data (the doc), not of the Print Job. If a Compression attribute is not
* specified for a doc, the printer assumes the doc's print data is uncompressed
* (i.e., the default Compression value is always {@link #NONE
- * NONE}).
+ * NONE}).
*
* IPP Compatibility: The category name returned by
* |
*
- * {@link #NONE NONE}
+ * {@link #NONE NONE}
* |
*
- * {@link #STAPLE STAPLE}
+ * {@link #STAPLE STAPLE}
* |
*
- * {@link #EDGE_STITCH EDGE_STITCH}
+ * {@link #EDGE_STITCH EDGE_STITCH}
* |
* |||||||||||||||
- * {@link #BIND BIND}
+ * {@link #BIND BIND}
* |
*
- * {@link #SADDLE_STITCH SADDLE_STITCH}
+ * {@link #SADDLE_STITCH SADDLE_STITCH}
* |
*
- * {@link #COVER COVER}
+ * {@link #COVER COVER}
* |
* * @@ -82,13 +82,13 @@ import javax.print.attribute.PrintJobAttribute; * * | *
- * {@link #STAPLE_TOP_LEFT STAPLE_TOP_LEFT}
+ * {@link #STAPLE_TOP_LEFT STAPLE_TOP_LEFT}
* |
*
- * {@link #EDGE_STITCH_LEFT EDGE_STITCH_LEFT}
+ * {@link #EDGE_STITCH_LEFT EDGE_STITCH_LEFT}
* |
*
- * {@link #STAPLE_DUAL_LEFT STAPLE_DUAL_LEFT}
+ * {@link #STAPLE_DUAL_LEFT STAPLE_DUAL_LEFT}
* |
* * @@ -99,13 +99,13 @@ import javax.print.attribute.PrintJobAttribute; * * | *
- * {@link #STAPLE_BOTTOM_LEFT STAPLE_BOTTOM_LEFT}
+ * {@link #STAPLE_BOTTOM_LEFT STAPLE_BOTTOM_LEFT}
* |
*
- * {@link #EDGE_STITCH_TOP EDGE_STITCH_TOP}
+ * {@link #EDGE_STITCH_TOP EDGE_STITCH_TOP}
* |
*
- * {@link #STAPLE_DUAL_TOP STAPLE_DUAL_TOP}
+ * {@link #STAPLE_DUAL_TOP STAPLE_DUAL_TOP}
* |
* * @@ -116,13 +116,13 @@ import javax.print.attribute.PrintJobAttribute; * * | *
- * {@link #STAPLE_TOP_RIGHT STAPLE_TOP_RIGHT}
+ * {@link #STAPLE_TOP_RIGHT STAPLE_TOP_RIGHT}
* |
*
- * {@link #EDGE_STITCH_RIGHT EDGE_STITCH_RIGHT}
+ * {@link #EDGE_STITCH_RIGHT EDGE_STITCH_RIGHT}
* |
*
- * {@link #STAPLE_DUAL_RIGHT STAPLE_DUAL_RIGHT}
+ * {@link #STAPLE_DUAL_RIGHT STAPLE_DUAL_RIGHT}
* |
* * @@ -133,13 +133,13 @@ import javax.print.attribute.PrintJobAttribute; * * | *
- * {@link #STAPLE_BOTTOM_RIGHT STAPLE_BOTTOM_RIGHT}
+ * {@link #STAPLE_BOTTOM_RIGHT STAPLE_BOTTOM_RIGHT}
* |
*
- * {@link #EDGE_STITCH_BOTTOM EDGE_STITCH_BOTTOM}
+ * {@link #EDGE_STITCH_BOTTOM EDGE_STITCH_BOTTOM}
* |
*
- * {@link #STAPLE_DUAL_BOTTOM STAPLE_DUAL_BOTTOM}
+ * {@link #STAPLE_DUAL_BOTTOM STAPLE_DUAL_BOTTOM}
* |
* * @@ -147,16 +147,16 @@ import javax.print.attribute.PrintJobAttribute; * |
- * The STAPLE_XXX values are specified with respect to the
+ * The STAPLE_XXX values are specified with respect to the
* document as if the document were a portrait document. If the document is
* actually a landscape or a reverse-landscape document, the client supplies the
* appropriate transformed value. For example, to position a staple in the upper
* left hand corner of a landscape document when held for reading, the client
- * supplies the STAPLE_BOTTOM_LEFT value (since landscape is
+ * supplies the STAPLE_BOTTOM_LEFT value (since landscape is
* defined as a +90 degree rotation from portrait, i.e., anti-clockwise). On the
* other hand, to position a staple in the upper left hand corner of a
* reverse-landscape document when held for reading, the client supplies the
- * STAPLE_TOP_RIGHT value (since reverse-landscape is defined as a
+ * STAPLE_TOP_RIGHT value (since reverse-landscape is defined as a
* -90 degree rotation from portrait, i.e., clockwise).
*
* The angle (vertical, horizontal, angled) of each staple with respect to the diff --git a/src/share/classes/javax/print/attribute/standard/JobKOctets.java b/src/share/classes/javax/print/attribute/standard/JobKOctets.java index 8f29b7b2c661b0ec8117eacd7c9910e64653681b..f5b16307df9580e6e6f150ad76484171b2e10e53 100644 --- a/src/share/classes/javax/print/attribute/standard/JobKOctets.java +++ b/src/share/classes/javax/print/attribute/standard/JobKOctets.java @@ -67,7 +67,7 @@ import javax.print.attribute.PrintJobAttribute; * shown in the table below. *
*
| Representation Class | *Document Size | *
|---|