--- old/src/java.desktop/share/classes/javax/print/attribute/standard/package-info.java 2017-07-16 16:18:37.000000000 -0700 +++ new/src/java.desktop/share/classes/javax/print/attribute/standard/package-info.java 2017-07-16 16:18:37.000000000 -0700 @@ -24,8 +24,8 @@ */ /** - * Package javax.print.attribute.standard contains classes for specific printing - * attributes. The parent package, + * Package {@code javax.print.attribute.standard} contains classes for specific + * printing attributes. The parent package, * javax.print.attribute, provides classes and interfaces that describe the * types of Java Print Service attributes and how they can be collected into * attribute sets. @@ -43,19 +43,19 @@ * support them. These support requirements are recorded in the documentation * for each attribute class. *

- * Package javax.print.attribute.standard contains standard printing attributes - * and standard printing attribute values that are widely used in the printing - * domain. A print service vendor can provide new vendor-specific printing - * attributes in addition to the standard ones. A vendor can also provide - * vendor-specific extensions (subclasses) of the standard printing attributes - * -- for example, to provide additional vendor-specific values for an existing - * standard attribute. Of course, if a vendor wants clients to be able to use - * any added or extended attributes, the vendor must publish the new attribute - * classes. + * Package {@code javax.print.attribute.standard} contains standard printing + * attributes and standard printing attribute values that are widely used in the + * printing domain. A print service vendor can provide new vendor-specific + * printing attributes in addition to the standard ones. A vendor can also + * provide vendor-specific extensions (subclasses) of the standard printing + * attributes -- for example, to provide additional vendor-specific values for + * an existing standard attribute. Of course, if a vendor wants clients to be + * able to use any added or extended attributes, the vendor must publish the new + * attribute classes. *

* Many of the standard attribute classes extend one of the abstract syntax - * classes of the javax.print.attribute package. These abstract syntax classes - * each represent a different type. The + * classes of the {@code javax.print.attribute} package. These abstract syntax + * classes each represent a different type. The * EnumSyntax class, for example, represents a type-safe enumeration. The * abstract syntax class provides a wrapper for the attribute value. *

@@ -73,9 +73,9 @@ * attribute classes in package javax.print.attribute.standard, just the ones * that pertain to the application. *

- * The attribute classes in package javax.print.attribute.standard are based on - * the Internet Printing Protocol (IPP) attributes as defined in the Internet - * RFC document, RFC 2911 Internet Printing Protocol/1.1: Model and + * The attribute classes in package {@code javax.print.attribute.standard} are + * based on the Internet Printing Protocol (IPP) attributes as defined in the + * Internet RFC document, RFC 2911 Internet Printing Protocol/1.1: Model and * Semantics dated September 2000. See * RFC 2911 for more * information. The descriptive text for each attribute class was taken largely @@ -152,485 +152,418 @@ * indicates the supported values for that attribute category. * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Attribute ClassDoc
Attribute		Print
Request
Attribute		Print
Job
Attribute		Print
Service
Attribute		SupportedValuesAttribute
CompressionX    
DocumentNameX    
ChromaticityXXX  
Copies XX CopiesSupported
FinishingsXXX  
JobHoldUntil XX  
JobImpressions XX  - * JobImpressionsSupported
JobKOctets XX JobKOctetsSupported
JobMediaSheets XX  - * JobMediaSheetsSupported
JobName XX  
JobPriority XX JobPrioritySupported
JobSheets XX  
MediaXXX  
MediaSize     
- * MultipleDocumentHandling XX  
NumberUpXXX NumberUpSupported
OrientationRequestedXXX  
PageRangesXXX  
- * PresentationDirectionXXX  
PrinterResolutionXXX  
PrintQualityXXX  
RequestingUserName XX  
SheetCollateXXX  
SidesXXX  
DateTimeAtCompleted  X  
DateTimeAtCreation  X  
DateTimeAtProcessing  X  
- * JobImpressionsCompleted  X  
JobKOctetsProcessed  X  
- * JobMediaSheetsCompleted  X  
- * JobMessageFromOperator  X  
- * JobOriginatingUserName  X  
JobState  X  
JobStateReasons
- * Contains zero or more --		  X  
-- JobStateReason     
NumberOfDocuments  X  
- * NumberOfInterveningJobs  X  
OutputDeviceAssigned  X  
ColorSupported   X 
PagesPerMinute   X 
PagesPerMinuteColor   X 
PDLOverrideSupported   X 
- * PrinterIsAcceptingJobs   X 
PrinterInfo   X 
PrinterLocation   X 
- * PrinterMessageFromOperator   X 
PrinterMakeAndModel   X 
PrinterMoreInfo   X 
- * PrinterMoreInfoManufacturer   X 
PrinterName   X 
PrinterState   X 
PrinterStateReasons
- * Contains zero or more --		   X 
-- PrinterStateReason     
-- Severity     
QueuedJobCount   X 
- * ReferenceUriSchemesSupported     
Attribute Class + * Doc
Attribute + * 		Print
Request
Attribute + * 		Print
Job
Attribute + * 		Print
Service
Attribute + * 		SupportedValuesAttribute + *
Compression + * X + *   + *   + *   + *   + *
DocumentName + * X + *   + *   + *   + *   + *
Chromaticity + * X + * X + * X + *   + *   + *
Copies + *   + * X + * X + *   + * CopiesSupported + *
Finishings + * X + * X + * X + *   + *   + *
JobHoldUntil + *   + * X + * X + *   + *   + *
JobImpressions + *   + * X + * X + *   + * JobImpressionsSupported + *
JobKOctets + *   + * X + * X + *   + * JobKOctetsSupported + *
JobMediaSheets + *   + * X + * X + *   + * JobMediaSheetsSupported + *
JobName + *   + * X + * X + *   + *   + *
JobPriority + *   + * X + * X + *   + * JobPrioritySupported + *
JobSheets + *   + * X + * X + *   + *   + *
Media + * X + * X + * X + *   + *   + *
MediaSize + *   + *   + *   + *   + *   + *
MultipleDocumentHandling + *   + * X + * X + *   + *   + *
NumberUp + * X + * X + * X + *   + * NumberUpSupported + *
OrientationRequested + * X + * X + * X + *   + *   + *
PageRanges + * X + * X + * X + *   + *   + *
PresentationDirection + * X + * X + * X + *   + *   + *
PrinterResolution + * X + * X + * X + *   + *   + *
PrintQuality + * X + * X + * X + *   + *   + *
RequestingUserName + *   + * X + * X + *   + *   + *
SheetCollate + * X + * X + * X + *   + *   + *
Sides + * X + * X + * X + *   + *   + *
DateTimeAtCompleted + *   + *   + * X + *   + *   + *
DateTimeAtCreation + *   + *   + * X + *   + *   + *
DateTimeAtProcessing + *   + *   + * X + *   + *   + *
JobImpressionsCompleted + *   + *   + * X + *   + *   + *
JobKOctetsProcessed + *   + *   + * X + *   + *   + *
JobMediaSheetsCompleted + *   + *   + * X + *   + *   + *
JobMessageFromOperator + *   + *   + * X + *   + *   + *
JobOriginatingUserName + *   + *   + * X + *   + *   + *
JobState + *   + *   + * X + *   + *   + *
JobStateReasons
+ * Contains zero or more -- + * 		  + *   + * X + *   + *   + *
-- JobStateReason + *   + *   + *   + *   + *   + *
NumberOfDocuments + *   + *   + * X + *   + *   + *
NumberOfInterveningJobs + *   + *   + * X + *   + *   + *
OutputDeviceAssigned + *   + *   + * X + *   + *   + *
ColorSupported + *   + *   + *   + * X + *   + *
PagesPerMinute + *   + *   + *   + * X + *   + *
PagesPerMinuteColor + *   + *   + *   + * X + *   + *
PDLOverrideSupported + *   + *   + *   + * X + *   + *
PrinterIsAcceptingJobs + *   + *   + *   + * X + *   + *
PrinterInfo + *   + *   + *   + * X + *   + *
PrinterLocation + *   + *   + *   + * X + *   + *
+ * PrinterMessageFromOperator + *   + *   + *   + * X + *   + *
PrinterMakeAndModel + *   + *   + *   + * X + *   + *
PrinterMoreInfo + *   + *   + *   + * X + *   + *
+ * PrinterMoreInfoManufacturer + *   + *   + *   + * X + *   + *
PrinterName + *   + *   + *   + * X + *   + *
PrinterState + *   + *   + *   + * X + *   + *
PrinterStateReasons
+ * Contains zero or more -- + * 		  + *   + *   + * X + *   + *
-- PrinterStateReason + *   + *   + *   + *   + *   + *
-- Severity + *   + *   + *   + *   + *   + *
QueuedJobCount + *   + *   + *   + * X + *   + *
+ * ReferenceUriSchemesSupported + *   + *   + *   + *   + *   *
*

- * Please note: In the javax.print APIs, a null reference parameter to methods - * is incorrect unless explicitly documented on the method as having a - * meaningful interpretation. Usage to the contrary is incorrect coding and may - * result in a run time exception either immediately or at some later time. - * IllegalArgumentException and NullPointerException are examples of typical and - * acceptable run time exceptions for such cases. + * Please note: In the {@code javax.print} APIs, a {@code null} reference + * parameter to methods is incorrect unless explicitly documented on the method + * as having a meaningful interpretation. Usage to the contrary is incorrect + * coding and may result in a run time exception either immediately or at some + * later time. {@code IllegalArgumentException} and {@code NullPointerException} + * are examples of typical and acceptable run time exceptions for such cases. * * @since 1.4 */