--- old/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterIsAcceptingJobs.java 2017-07-16 16:18:24.000000000 -0700 +++ new/src/java.desktop/share/classes/javax/print/attribute/standard/PrinterIsAcceptingJobs.java 2017-07-16 16:18:24.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 @@ -22,6 +22,7 @@ * or visit www.oracle.com if you need additional information or have any * questions. */ + package javax.print.attribute.standard; import javax.print.attribute.Attribute; @@ -29,26 +30,30 @@ import javax.print.attribute.PrintServiceAttribute; /** - * Class PrinterIsAcceptingJobs is a printing attribute class, an enumeration, - * that indicates whether the printer is currently able to accept jobs. This - * value is independent of the {@link PrinterState PrinterState} and {@link - * PrinterStateReasons PrinterStateReasons} attributes because its value does - * not affect the current job; rather it affects future jobs. If the value is - * NOT_ACCEPTING_JOBS, the printer will reject jobs even when the {@link - * PrinterState PrinterState} is IDLE. If value is ACCEPTING_JOBS, the Printer - * will accept jobs even when the {@link PrinterState PrinterState} is STOPPED. - *

- * IPP Compatibility: The IPP boolean value is "true" for ACCEPTING_JOBS - * and "false" for NOT_ACCEPTING_JOBS. The category name returned by - * {@code getName()} is the IPP attribute name. The enumeration's - * integer value is the IPP enum value. The {@code toString()} method - * returns the IPP string representation of the attribute value. + * Class {@code PrinterIsAcceptingJobs} is a printing attribute class, an + * enumeration, that indicates whether the printer is currently able to accept + * jobs. This value is independent of the {@link PrinterState PrinterState} and + * {@link PrinterStateReasons PrinterStateReasons} attributes because its value + * does not affect the current job; rather it affects future jobs. If the value + * is {@code NOT_ACCEPTING_JOBS}, the printer will reject jobs even when the + * {@link PrinterState PrinterState} is {@code IDLE}. If value is + * {@code ACCEPTING_JOBS}, the Printer will accept jobs even when the + * {@link PrinterState PrinterState} is {@code STOPPED}. + *

+ * IPP Compatibility: The IPP boolean value is "true" for + * {@code ACCEPTING_JOBS} and "false" for {@code NOT_ACCEPTING_JOBS}. The + * category name returned by {@code getName()} is the IPP attribute name. The + * enumeration's integer value is the IPP enum value. The {@code toString()} + * method returns the IPP string representation of the attribute value. * - * @author Alan Kaminsky + * @author Alan Kaminsky */ public final class PrinterIsAcceptingJobs extends EnumSyntax implements PrintServiceAttribute { + /** + * Use serialVersionUID from JDK 1.4 for interoperability. + */ private static final long serialVersionUID = -5052010680537678061L; /** @@ -67,31 +72,38 @@ * Construct a new printer is accepting jobs enumeration value with the * given integer value. * - * @param value Integer value. + * @param value Integer value */ protected PrinterIsAcceptingJobs(int value) { super (value); } + /** + * The string table for class {@code PrinterIsAcceptingJobs}. + */ private static final String[] myStringTable = { "not-accepting-jobs", "accepting-jobs" }; + /** + * The enumeration value table for class {@code PrinterIsAcceptingJobs}. + */ private static final PrinterIsAcceptingJobs[] myEnumValueTable = { NOT_ACCEPTING_JOBS, ACCEPTING_JOBS }; /** - * Returns the string table for class PrinterIsAcceptingJobs. + * Returns the string table for class {@code PrinterIsAcceptingJobs}. */ protected String[] getStringTable() { return myStringTable; } /** - * Returns the enumeration value table for class PrinterIsAcceptingJobs. + * Returns the enumeration value table for class + * {@code PrinterIsAcceptingJobs}. */ protected EnumSyntax[] getEnumValueTable() { return myEnumValueTable; @@ -100,12 +112,12 @@ /** * Get the printing attribute class which is to be used as the "category" * for this printing attribute value. - *

- * For class PrinterIsAcceptingJobs, the - * category is class PrinterIsAcceptingJobs itself. + *

+ * For class {@code PrinterIsAcceptingJobs}, the category is class + * {@code PrinterIsAcceptingJobs} itself. * - * @return Printing attribute class (category), an instance of class - * {@link java.lang.Class java.lang.Class}. + * @return printing attribute class (category), an instance of class + * {@link Class java.lang.Class} */ public final Class getCategory() { return PrinterIsAcceptingJobs.class; @@ -114,14 +126,13 @@ /** * Get the name of the category of which this attribute value is an * instance. - *

- * For class PrinterIsAcceptingJobs, the - * category name is {@code "printer-is-accepting-jobs"}. + *

+ * For class {@code PrinterIsAcceptingJobs}, the category name is + * {@code "printer-is-accepting-jobs"}. * - * @return Attribute category name. + * @return attribute category name */ public final String getName() { return "printer-is-accepting-jobs"; } - }