package-info.java revision 16866:708f958bee98
19Sjkh/*
29Sjkh * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.
39Sjkh * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
49Sjkh *
550472Speter * This code is free software; you can redistribute it and/or modify it
69Sjkh * under the terms of the GNU General Public License version 2 only, as
79Sjkh * published by the Free Software Foundation.  Oracle designates this
89Sjkh * particular file as subject to the "Classpath" exception as provided
99Sjkh * by Oracle in the LICENSE file that accompanied this code.
109Sjkh *
119Sjkh * This code is distributed in the hope that it will be useful, but WITHOUT
129Sjkh * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
139Sjkh * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
149Sjkh * version 2 for more details (a copy is included in the LICENSE file that
159Sjkh * accompanied this code).
169Sjkh *
179Sjkh * You should have received a copy of the GNU General Public License version
189Sjkh * 2 along with this work; if not, write to the Free Software Foundation,
199Sjkh * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
209Sjkh *
219Sjkh * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
229Sjkh * or visit www.oracle.com if you need additional information or have any
239Sjkh * questions.
249Sjkh */
259Sjkh
269Sjkh/**
279Sjkh * Package javax.print.attribute.standard contains classes for specific printing
289Sjkh * attributes. The parent package, <a href="../package-summary.html">
299Sjkh * javax.print.attribute</a>, provides classes and interfaces that describe the
309Sjkh * types of Java Print Service attributes and how they can be collected into
319Sjkh * attribute sets.
329Sjkh * <p>
339Sjkh * An attribute represents a printing feature that a print service can provide.
349Sjkh * For each attribute, a print service either does or does not support the
359Sjkh * attribute. For each possible value of a supported attribute, a print service
369Sjkh * either does or does not support the value.
379Sjkh * <p>
389Sjkh * The API requires every print service to support certain attributes; other
399Sjkh * attributes are optional and the service can choose whether or not to support
409Sjkh * them. Each attribute has a set of values that it accepts. The API requires
4111891Speter * every print service to support certain values for certain attributes; other
4211891Speter * attribute values are optional and the service can choose whether or not to
4311891Speter * support them. These support requirements are recorded in the documentation
4411891Speter * for each attribute class.
4511891Speter * <p>
4611891Speter * Package javax.print.attribute.standard contains standard printing attributes
4711891Speter * and standard printing attribute values that are widely used in the printing
4811891Speter * domain. A print service vendor can provide new vendor-specific printing
4911891Speter * attributes in addition to the standard ones. A vendor can also provide
5011891Speter * vendor-specific extensions (subclasses) of the standard printing attributes
5111891Speter * -- for example, to provide additional vendor-specific values for an existing
5211891Speter * standard attribute. Of course, if a vendor wants clients to be able to use
5311891Speter * any added or extended attributes, the vendor must publish the new attribute
5411891Speter * classes.
5511891Speter * <p>
5611891Speter * Many of the standard attribute classes extend one of the abstract syntax
5711891Speter * classes of the javax.print.attribute package. These abstract syntax classes
5811891Speter * each represent a different type. The <a href="../EnumSyntax.html">
5911891Speter * EnumSyntax</a> class, for example, represents a type-safe enumeration. The
6011891Speter * abstract syntax class provides a wrapper for the attribute value.
6111891Speter * <p>
6211891Speter * If an attribute class extends {@code EnumSyntax}, and the value of the
6311891Speter * attribute is an IPP-compatible value, the attribute's {@code toString} method
6411891Speter * returns the IPP string representation of the attribute value, such as
6511891Speter * "processing-stopped" for the <a href="JobState.html">JobState</a> attribute.
6611891Speter * However, because the {@code EnumSyntax} class is extensible, vendors can
6711891Speter * define their own attribute values. If an attribute uses the
6811891Speter * {@code EnumSyntax} class and is set to one of these vendor-defined values
6911891Speter * then the {@code toString} method will not return the IPP string
709Sjkh * representation of the value.
719Sjkh * <p>
729Sjkh * A printing client application will typically not need to use all the printing
739Sjkh * attribute classes in package javax.print.attribute.standard, just the ones
749Sjkh * that pertain to the application.
759Sjkh * <p>
769Sjkh * The attribute classes in package javax.print.attribute.standard are based on
779Sjkh * the Internet Printing Protocol (IPP) attributes as defined in the Internet
789Sjkh * RFC document, <i>RFC 2911 Internet Printing Protocol/1.1: Model and
799Sjkh * Semantics</i> dated September 2000. See
809Sjkh * <a href="http://www.ietf.org/rfc/rfc2911.txt">RFC 2911</a> for more
819Sjkh * information. The descriptive text for each attribute class was taken largely
829Sjkh * from the above documents. The above authors' contribution to the API is
8311891Speter * gratefully acknowledged.
8411891Speter *
8511891Speter * <h3>Attribute Organization</h3>
8611891Speter * There are five kinds of printing attributes: doc attributes, print request
8711891Speter * attributes, print job attributes, print service attributes, and
889Sjkh * supported-values attributes.
899Sjkh *
909Sjkh * <h4>Doc Attributes</h4>
919Sjkh * Doc attributes specify the characteristics of an individual doc and the print
929Sjkh * job settings to be applied to an individual doc. A doc attribute class
939Sjkh * implements interface <a href="../DocAttribute.html">DocAttribute</a>. A doc
949Sjkh * attribute can appear in a <a href="../DocAttributeSet.html">
959Sjkh * DocAttributeSet</a>.
969Sjkh *
979Sjkh * <h4>Print Request Attributes</h4>
989Sjkh * Print request attributes specify the settings to be applied to a whole print
999Sjkh * job and to all the docs in the print job. A print request attribute class
1009Sjkh * implements interface <a href="../PrintRequestAttribute.html">
1019Sjkh * PrintRequestAttribute</a>. A print request attribute can appear in a
10211891Speter * <a href="../PrintRequestAttributeSet.html">PrintRequestAttributeSet</a>.
10311891Speter * <p>
10411891Speter * Some attributes are doc attributes but not print request attributes and may
10511891Speter * only be specified at the doc level. Some attributes are print request
10611891Speter * attributes but not doc attributes and may only be specified at the Print
10711891Speter * Request level. Some attributes are both doc attributes and print request
10811891Speter * attributes and may be specified either at the doc level or at the Print
1099Sjkh * Request level.
1109Sjkh * <p>
1119Sjkh * When specified at the doc level, an attribute applies just to that one doc.
1129Sjkh * When specified at the Print Request level, an attribute applies to the whole
1139Sjkh * job, including all the docs in the job. However, an attribute specified at
1149Sjkh * the doc level overrides an attribute in the same category specified at the
1159Sjkh * Print Request level.
1169Sjkh *
1179Sjkh * <h4>Print Job Attributes</h4>
1189Sjkh * Print job attributes report the status of a Print Job. A print job attribute
1199Sjkh * class implements interface <a href="../PrintJobAttribute.html">
1209Sjkh * PrintJobAttribute</a>. A print job attribute can appear in a
1219Sjkh * <a href="../PrintJobAttributeSet.html">PrintJobAttributeSet</a>.
1229Sjkh * <p>
12311891Speter * Some attributes are both print request attributes and print job attributes; a
12411891Speter * client may include such attributes in a Print Request to specify
12511891Speter * characteristics for the ensuing Print Job, and those attributes then also
12611891Speter * appear in the Print Job's attribute set. Some attributes are print job
12711891Speter * attributes but not print request attributes; the print service itself adds
12811891Speter * these attributes to the Print Job's attribute set.
12911891Speter *
13011891Speter * <h4>Print Service Attributes</h4>
1319Sjkh * Print service attributes report the status of a print service. A print
1329Sjkh * service attribute class implements interface
1339Sjkh * <a href="../PrintServiceAttribute.html">PrintServiceAttribute</a>. A print
1349Sjkh * service attribute can appear in a <a href="../PrintServiceAttributeSet.html">
1359Sjkh * PrintServiceAttributeSet</a>.
1369Sjkh *
1379Sjkh * <h4>Supported-Values Attributes</h4>
1389Sjkh * A supported-value attribute indicates the legal values for another attribute
1399Sjkh * that a print service supports. A supported-values attribute class implements
1409Sjkh * interface <a href="../SupportedValuesAttribute.html">
1419Sjkh * SupportedValuesAttribute</a>. However, supported-values attributes never
1429Sjkh * appear in attribute sets, so there is no restricted
1439Sjkh * <a href="../AttributeSet.html">AttributeSet</a> subinterface for them.
1449Sjkh *
1459Sjkh * <h4>Attribute Table</h4>
1469Sjkh * The table below lists all the printing attributes. The table shows the
1479Sjkh * tagging interfaces each attribute class implements in addition to interface
1489Sjkh * <a href="../Attribute.html"> Attribute</a>, thus indicating how each
1499Sjkh * attribute is used in the API. For each doc attribute and print request
1509Sjkh * attribute, the column marked "SupportedValuesAttribute" lists the
1519Sjkh * supported-values attribute class, if any, with which a print service
1529Sjkh * indicates the supported values for that attribute category.
1539Sjkh * <table border=1 cellpadding=2 cellspacing=1 summary="Lists all printing
1549Sjkh * attributes as described in above text">
1559Sjkh *     <tr style="background-color:#E5E5E5">
1569Sjkh *         <th valign="bottom">Attribute Class</th>
1579Sjkh *         <th valign="bottom">Doc<br>Attribute</th>
1589Sjkh *         <th valign="bottom">Print<br>Request<br>Attribute</th>
1599Sjkh *         <th valign="bottom">Print<br>Job<br>Attribute</th>
1609Sjkh *         <th valign="bottom">Print<br>Service<br>Attribute</th>
1619Sjkh *         <th valign="bottom">SupportedValuesAttribute</th>
1629Sjkh *     </tr>
1639Sjkh *     <tr>
1649Sjkh *         <td><a href="Compression.html">Compression</a></td>
1659Sjkh *         <td align="center">X</td>
1669Sjkh *         <td>&nbsp;</td>
1679Sjkh *         <td>&nbsp;</td>
1689Sjkh *         <td>&nbsp;</td>
1699Sjkh *         <td>&nbsp;</td>
1709Sjkh *     </tr>
1719Sjkh *     <tr>
1729Sjkh *         <td><a href="DocumentName.html">DocumentName</a></td>
1739Sjkh *         <td align="center">X</td>
1749Sjkh *         <td>&nbsp;</td>
17511891Speter *         <td>&nbsp;</td>
1769Sjkh *         <td>&nbsp;</td>
17711891Speter *         <td>&nbsp;</td>
1789Sjkh *     </tr>
17911891Speter *     <tr>
1809Sjkh *         <td><a href="Chromaticity.html">Chromaticity</a></td>
1819Sjkh *         <td align="center">X</td>
1829Sjkh *         <td align="center">X</td>
1839Sjkh *         <td align="center">X</td>
1849Sjkh *         <td>&nbsp;</td>
1859Sjkh *         <td>&nbsp;</td>
1869Sjkh *     </tr>
1879Sjkh *     <tr>
1889Sjkh *         <td><a href="Copies.html">Copies</a></td>
1899Sjkh *         <td>&nbsp;</td>
190 *         <td align="center">X</td>
191 *         <td align="center">X</td>
192 *         <td>&nbsp;</td>
193 *         <td><a href="CopiesSupported.html">CopiesSupported</a></td>
194 *     </tr>
195 *     <tr>
196 *         <td><a href="Finishings.html">Finishings</a></td>
197 *         <td align="center">X</td>
198 *         <td align="center">X</td>
199 *         <td align="center">X</td>
200 *         <td>&nbsp;</td>
201 *         <td>&nbsp;</td>
202 *     </tr>
203 *     <tr>
204 *         <td><a href="JobHoldUntil.html">JobHoldUntil</a></td>
205 *         <td>&nbsp;</td>
206 *         <td align="center">X</td>
207 *         <td align="center">X</td>
208 *         <td>&nbsp;</td>
209 *         <td>&nbsp;</td>
210 *     </tr>
211 *     <tr>
212 *         <td><a href="JobImpressions.html">JobImpressions</a></td>
213 *         <td>&nbsp;</td>
214 *         <td align="center">X</td>
215 *         <td align="center">X</td>
216 *         <td>&nbsp;</td>
217 *         <td><a href="JobImpressionsSupported.html">
218 *             JobImpressionsSupported</a></td>
219 *     </tr>
220 *     <tr>
221 *         <td><a href="JobKOctets.html">JobKOctets</a></td>
222 *         <td>&nbsp;</td>
223 *         <td align="center">X</td>
224 *         <td align="center">X</td>
225 *         <td>&nbsp;</td>
226 *         <td><a href="JobKOctetsSupported.html">JobKOctetsSupported</a></td>
227 *     </tr>
228 *     <tr>
229 *         <td><a href="JobMediaSheets.html">JobMediaSheets</a></td>
230 *         <td>&nbsp;</td>
231 *         <td align="center">X</td>
232 *         <td align="center">X</td>
233 *         <td>&nbsp;</td>
234 *         <td><a href="JobMediaSheetsSupported.html">
235 *             JobMediaSheetsSupported</a></td>
236 *     </tr>
237 *     <tr>
238 *         <td><a href="JobName.html">JobName</a></td>
239 *         <td>&nbsp;</td>
240 *         <td align="center">X</td>
241 *         <td align="center">X</td>
242 *         <td>&nbsp;</td>
243 *         <td>&nbsp;</td>
244 *     </tr>
245 *     <tr>
246 *         <td><a href="JobPriority.html">JobPriority</a></td>
247 *         <td>&nbsp;</td>
248 *         <td align="center">X</td>
249 *         <td align="center">X</td>
250 *         <td>&nbsp;</td>
251 *         <td><a href="JobPrioritySupported.html">JobPrioritySupported</a></td>
252 *     </tr>
253 *     <tr>
254 *         <td><a href="JobSheets.html">JobSheets</a></td>
255 *         <td>&nbsp;</td>
256 *         <td align="center">X</td>
257 *         <td align="center">X</td>
258 *         <td>&nbsp;</td>
259 *         <td>&nbsp;</td>
260 *     </tr>
261 *     <tr>
262 *         <td><a href="Media.html">Media</a></td>
263 *         <td align="center">X</td>
264 *         <td align="center">X</td>
265 *         <td align="center">X</td>
266 *         <td>&nbsp;</td>
267 *         <td>&nbsp;</td>
268 *     </tr>
269 *     <tr>
270 *         <td><a href="MediaSize.html">MediaSize</a></td>
271 *         <td>&nbsp;</td>
272 *         <td>&nbsp;</td>
273 *         <td>&nbsp;</td>
274 *         <td>&nbsp;</td>
275 *         <td>&nbsp;</td>
276 *     </tr>
277 *     <tr>
278 *         <td><a href="MultipleDocumentHandling.html">
279 *             MultipleDocumentHandling</a></td>
280 *         <td>&nbsp;</td>
281 *         <td align="center">X</td>
282 *         <td align="center">X</td>
283 *         <td>&nbsp;</td>
284 *         <td>&nbsp;</td>
285 *     </tr>
286 *     <tr>
287 *         <td><a href="NumberUp.html">NumberUp</a></td>
288 *         <td align="center">X</td>
289 *         <td align="center">X</td>
290 *         <td align="center">X</td>
291 *         <td>&nbsp;</td>
292 *         <td><a href="NumberUpSupported.html">NumberUpSupported</a></td>
293 *     </tr>
294 *     <tr>
295 *         <td><a href="OrientationRequested.html">OrientationRequested</a></td>
296 *         <td align="center">X</td>
297 *         <td align="center">X</td>
298 *         <td align="center">X</td>
299 *         <td>&nbsp;</td>
300 *         <td>&nbsp;</td>
301 *     </tr>
302 *     <tr>
303 *         <td><a href="PageRanges.html">PageRanges</a></td>
304 *         <td align="center">X</td>
305 *         <td align="center">X</td>
306 *         <td align="center">X</td>
307 *         <td>&nbsp;</td>
308 *         <td>&nbsp;</td>
309 *     </tr>
310 *     <tr>
311 *         <td><a href="PresentationDirection.html">
312 *             PresentationDirection</a></td>
313 *         <td align="center">X</td>
314 *         <td align="center">X</td>
315 *         <td align="center">X</td>
316 *         <td>&nbsp;</td>
317 *         <td>&nbsp;</td>
318 *     </tr>
319 *     <tr>
320 *         <td><a href="PrinterResolution.html">PrinterResolution</a></td>
321 *         <td align="center">X</td>
322 *         <td align="center">X</td>
323 *         <td align="center">X</td>
324 *         <td>&nbsp;</td>
325 *         <td>&nbsp;</td>
326 *     </tr>
327 *     <tr>
328 *         <td><a href="PrintQuality.html">PrintQuality</a></td>
329 *         <td align="center">X</td>
330 *         <td align="center">X</td>
331 *         <td align="center">X</td>
332 *         <td>&nbsp;</td>
333 *         <td>&nbsp;</td>
334 *     </tr>
335 *     <tr>
336 *         <td><a href="RequestingUserName.html">RequestingUserName</a></td>
337 *         <td>&nbsp;</td>
338 *         <td align="center">X</td>
339 *         <td align="center">X</td>
340 *         <td>&nbsp;</td>
341 *         <td>&nbsp;</td>
342 *     </tr>
343 *     <tr>
344 *         <td><a href="SheetCollate.html">SheetCollate</a></td>
345 *         <td align="center">X</td>
346 *         <td align="center">X</td>
347 *         <td align="center">X</td>
348 *         <td>&nbsp;</td>
349 *         <td>&nbsp;</td>
350 *     </tr>
351 *     <tr>
352 *         <td><a href="Sides.html">Sides</a></td>
353 *         <td align="center">X</td>
354 *         <td align="center">X</td>
355 *         <td align="center">X</td>
356 *         <td>&nbsp;</td>
357 *         <td>&nbsp;</td>
358 *     </tr>
359 *     <tr>
360 *         <td><a href="DateTimeAtCompleted.html">DateTimeAtCompleted</a></td>
361 *         <td>&nbsp;</td>
362 *         <td>&nbsp;</td>
363 *         <td align="center">X</td>
364 *         <td>&nbsp;</td>
365 *         <td>&nbsp;</td>
366 *     </tr>
367 *     <tr>
368 *         <td><a href="DateTimeAtCreation.html">DateTimeAtCreation</a></td>
369 *         <td>&nbsp;</td>
370 *         <td>&nbsp;</td>
371 *         <td align="center">X</td>
372 *         <td>&nbsp;</td>
373 *         <td>&nbsp;</td>
374 *     </tr>
375 *     <tr>
376 *         <td><a href="DateTimeAtProcessing.html">DateTimeAtProcessing</a></td>
377 *         <td>&nbsp;</td>
378 *         <td>&nbsp;</td>
379 *         <td align="center">X</td>
380 *         <td>&nbsp;</td>
381 *         <td>&nbsp;</td>
382 *     </tr>
383 *     <tr>
384 *         <td><a href="JobImpressionsCompleted.html">
385 *             JobImpressionsCompleted</a></td>
386 *         <td>&nbsp;</td>
387 *         <td>&nbsp;</td>
388 *         <td align="center">X</td>
389 *         <td>&nbsp;</td>
390 *         <td>&nbsp;</td>
391 *     </tr>
392 *     <tr>
393 *         <td><a href="JobKOctetsProcessed.html">JobKOctetsProcessed</a></td>
394 *         <td>&nbsp;</td>
395 *         <td>&nbsp;</td>
396 *         <td align="center">X</td>
397 *         <td>&nbsp;</td>
398 *         <td>&nbsp;</td>
399 *     </tr>
400 *     <tr>
401 *         <td><a href="JobMediaSheetsCompleted.html">
402 *             JobMediaSheetsCompleted</a></td>
403 *         <td>&nbsp;</td>
404 *         <td>&nbsp;</td>
405 *         <td align="center">X</td>
406 *         <td>&nbsp;</td>
407 *         <td>&nbsp;</td>
408 *     </tr>
409 *     <tr>
410 *         <td><a href="JobMessageFromOperator.html">
411 *             JobMessageFromOperator</a></td>
412 *         <td>&nbsp;</td>
413 *         <td>&nbsp;</td>
414 *         <td align="center">X</td>
415 *         <td>&nbsp;</td>
416 *         <td>&nbsp;</td>
417 *     </tr>
418 *     <tr>
419 *         <td><a href="JobOriginatingUserName.html">
420 *             JobOriginatingUserName</a></td>
421 *         <td>&nbsp;</td>
422 *         <td>&nbsp;</td>
423 *         <td align="center">X</td>
424 *         <td>&nbsp;</td>
425 *         <td>&nbsp;</td>
426 *     </tr>
427 *     <tr>
428 *         <td><a href="JobState.html">JobState</a></td>
429 *         <td>&nbsp;</td>
430 *         <td>&nbsp;</td>
431 *         <td align="center">X</td>
432 *         <td>&nbsp;</td>
433 *         <td>&nbsp;</td>
434 *         </tr>
435 *     <tr>
436 *         <td><a href="JobStateReasons.html">JobStateReasons</a><br>
437 *             Contains zero or more --</td>
438 *         <td>&nbsp;</td>
439 *         <td>&nbsp;</td>
440 *         <td align="center">X</td>
441 *         <td>&nbsp;</td>
442 *         <td>&nbsp;</td>
443 *     </tr>
444 *     <tr>
445 *         <td>-- <a href="JobStateReason.html">JobStateReason</a></td>
446 *         <td>&nbsp;</td>
447 *         <td>&nbsp;</td>
448 *         <td>&nbsp;</td>
449 *         <td>&nbsp;</td>
450 *         <td>&nbsp;</td>
451 *     </tr>
452 *     <tr>
453 *         <td><a href="NumberOfDocuments.html">NumberOfDocuments</a></td>
454 *         <td>&nbsp;</td>
455 *         <td>&nbsp;</td>
456 *         <td align="center">X</td>
457 *         <td>&nbsp;</td>
458 *         <td>&nbsp;</td>
459 *     </tr>
460 *     <tr>
461 *         <td><a href="NumberOfInterveningJobs.html">
462 *             NumberOfInterveningJobs</a></td>
463 *         <td>&nbsp;</td>
464 *         <td>&nbsp;</td>
465 *         <td align="center">X</td>
466 *         <td>&nbsp;</td>
467 *         <td>&nbsp;</td>
468 *     </tr>
469 *     <tr>
470 *         <td><a href="OutputDeviceAssigned.html">OutputDeviceAssigned</a></td>
471 *         <td>&nbsp;</td>
472 *         <td>&nbsp;</td>
473 *         <td align="center">X</td>
474 *         <td>&nbsp;</td>
475 *         <td>&nbsp;</td>
476 *     </tr>
477 *     <tr>
478 *         <td><a href="ColorSupported.html">ColorSupported</a></td>
479 *         <td>&nbsp;</td>
480 *         <td>&nbsp;</td>
481 *         <td>&nbsp;</td>
482 *         <td align="center">X</td>
483 *         <td>&nbsp;</td>
484 *     </tr>
485 *     <tr>
486 *         <td><a href="PagesPerMinute.html">PagesPerMinute</a></td>
487 *         <td>&nbsp;</td>
488 *         <td>&nbsp;</td>
489 *         <td>&nbsp;</td>
490 *         <td align="center">X</td>
491 *         <td>&nbsp;</td>
492 *     </tr>
493 *     <tr>
494 *         <td><a href="PagesPerMinuteColor.html">PagesPerMinuteColor</a></td>
495 *         <td>&nbsp;</td>
496 *         <td>&nbsp;</td>
497 *         <td>&nbsp;</td>
498 *         <td align="center">X</td>
499 *         <td>&nbsp;</td>
500 *     </tr>
501 *     <tr>
502 *         <td><a href="PDLOverrideSupported.html">PDLOverrideSupported</a></td>
503 *         <td>&nbsp;</td>
504 *         <td>&nbsp;</td>
505 *         <td>&nbsp;</td>
506 *         <td align="center">X</td>
507 *         <td>&nbsp;</td>
508 *     </tr>
509 *     <tr>
510 *         <td><a href="PrinterIsAcceptingJobs.html">
511 *             PrinterIsAcceptingJobs</a></td>
512 *         <td>&nbsp;</td>
513 *         <td>&nbsp;</td>
514 *         <td>&nbsp;</td>
515 *         <td align="center">X</td>
516 *         <td>&nbsp;</td>
517 *     </tr>
518 *     <tr>
519 *         <td><a href="PrinterInfo.html">PrinterInfo</a></td>
520 *         <td>&nbsp;</td>
521 *         <td>&nbsp;</td>
522 *         <td>&nbsp;</td>
523 *         <td align="center">X</td>
524 *         <td>&nbsp;</td>
525 *     </tr>
526 *     <tr>
527 *         <td><a href="PrinterLocation.html">PrinterLocation</a></td>
528 *         <td>&nbsp;</td>
529 *         <td>&nbsp;</td>
530 *         <td>&nbsp;</td>
531 *         <td align="center">X</td>
532 *         <td>&nbsp;</td>
533 *     </tr>
534 *     <tr>
535 *         <td><a href="PrinterMessageFromOperator.html">
536 *             PrinterMessageFromOperator</a></td>
537 *         <td>&nbsp;</td>
538 *         <td>&nbsp;</td>
539 *         <td>&nbsp;</td>
540 *         <td align="center">X</td>
541 *         <td>&nbsp;</td>
542 *     </tr>
543 *     <tr>
544 *         <td><a href="PrinterMakeAndModel.html">PrinterMakeAndModel</a></td>
545 *         <td>&nbsp;</td>
546 *         <td>&nbsp;</td>
547 *         <td>&nbsp;</td>
548 *         <td align="center">X</td>
549 *         <td>&nbsp;</td>
550 *     </tr>
551 *     <tr>
552 *         <td><a href="PrinterMoreInfo.html">PrinterMoreInfo</a></td>
553 *         <td>&nbsp;</td>
554 *         <td>&nbsp;</td>
555 *         <td>&nbsp;</td>
556 *         <td align="center">X</td>
557 *         <td>&nbsp;</td>
558 *     </tr>
559 *     <tr>
560 *         <td><a href="PrinterMoreInfoManufacturer.html">
561 *             PrinterMoreInfoManufacturer</a></td>
562 *         <td>&nbsp;</td>
563 *         <td>&nbsp;</td>
564 *         <td>&nbsp;</td>
565 *         <td align="center">X</td>
566 *         <td>&nbsp;</td>
567 *     </tr>
568 *     <tr>
569 *         <td><a href="PrinterName.html">PrinterName</a></td>
570 *         <td>&nbsp;</td>
571 *         <td>&nbsp;</td>
572 *         <td>&nbsp;</td>
573 *         <td align="center">X</td>
574 *         <td>&nbsp;</td>
575 *     </tr>
576 *     <tr>
577 *         <td><a href="PrinterState.html">PrinterState</a></td>
578 *         <td>&nbsp;</td>
579 *         <td>&nbsp;</td>
580 *         <td>&nbsp;</td>
581 *         <td align="center">X</td>
582 *         <td>&nbsp;</td>
583 *     </tr>
584 *     <tr>
585 *         <td><a href="PrinterStateReasons.html">PrinterStateReasons</a><br>
586 *             Contains zero or more --</td>
587 *         <td>&nbsp;</td>
588 *         <td>&nbsp;</td>
589 *         <td>&nbsp;</td>
590 *         <td align="center">X</td>
591 *         <td>&nbsp;</td>
592 *     </tr>
593 *     <tr>
594 *         <td>-- <a href="PrinterStateReason.html">PrinterStateReason</a></td>
595 *         <td>&nbsp;</td>
596 *         <td>&nbsp;</td>
597 *         <td>&nbsp;</td>
598 *         <td>&nbsp;</td>
599 *         <td>&nbsp;</td>
600 *     </tr>
601 *     <tr>
602 *         <td>-- <a href="Severity.html">Severity</a></td>
603 *         <td>&nbsp;</td>
604 *         <td>&nbsp;</td>
605 *         <td>&nbsp;</td>
606 *         <td>&nbsp;</td>
607 *         <td>&nbsp;</td>
608 *     </tr>
609 *     <tr>
610 *         <td><a href="QueuedJobCount.html">QueuedJobCount</a></td>
611 *         <td>&nbsp;</td>
612 *         <td>&nbsp;</td>
613 *         <td>&nbsp;</td>
614 *         <td align="center">X</td>
615 *         <td>&nbsp;</td>
616 *     </tr>
617 *     <tr>
618 *         <td><a href="ReferenceUriSchemesSupported.html">
619 *             ReferenceUriSchemesSupported</a></td>
620 *         <td>&nbsp;</td>
621 *         <td>&nbsp;</td>
622 *         <td>&nbsp;</td>
623 *         <td>&nbsp;</td>
624 *         <td>&nbsp;</td>
625 *     </tr>
626 * </table>
627 * <p>
628 * Please note: In the javax.print APIs, a null reference parameter to methods
629 * is incorrect unless explicitly documented on the method as having a
630 * meaningful interpretation. Usage to the contrary is incorrect coding and may
631 * result in a run time exception either immediately or at some later time.
632 * IllegalArgumentException and NullPointerException are examples of typical and
633 * acceptable run time exceptions for such cases.
634 *
635 * @since 1.4
636 */
637package javax.print.attribute.standard;
638