src/java.desktop/share/classes/javax/print/event/PrintServiceAttributeEvent.java

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 2000, 2003, 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
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this

@@ -28,57 +28,57 @@
 import javax.print.PrintService;
 import javax.print.attribute.AttributeSetUtilities;
 import javax.print.attribute.PrintServiceAttributeSet;
 
 /**
- *
- * Class PrintServiceAttributeEvent encapsulates an event a
- * Print Service instance reports to let the client know of
- * changes in the print service state.
+ * Class {@code PrintServiceAttributeEvent} encapsulates an event a Print
+ * Service instance reports to let the client know of changes in the print
+ * service state.
  */
-
 public class PrintServiceAttributeEvent extends PrintEvent {
 
+    /**
+     * Use serialVersionUID from JDK 1.4 for interoperability.
+     */
     private static final long serialVersionUID = -7565987018140326600L;
 
+    /**
+     * The printing service attributes that changed.
+     */
     private PrintServiceAttributeSet attributes;
 
     /**
-     * Constructs a PrintServiceAttributeEvent object.
+     * Constructs a {@code PrintServiceAttributeEvent} object.
      *
      * @param source the print job generating  this event
      * @param attributes the attribute changes being reported
-     * @throws IllegalArgumentException if {@code source} is
-     *         {@code null}.
+     * @throws IllegalArgumentException if {@code source} is {@code null}
      */
     public PrintServiceAttributeEvent(PrintService source,
                                       PrintServiceAttributeSet attributes) {
 
         super(source);
         this.attributes = AttributeSetUtilities.unmodifiableView(attributes);
     }
 
-
     /**
      * Returns the print service.
-
-     * @return  Print Service object.
+     *
+     * @return {@code PrintService} object
      */
     public PrintService getPrintService() {
 
         return (PrintService) getSource();
     }
 
-
     /**
      * Determine the printing service attributes that changed and their new
      * values.
      *
-     * @return  Attributes containing the new values for the service
-     * attributes that changed. The returned set may be unmodifiable.
+     * @return attributes containing the new values for the service attributes
+     *         that changed. The returned set may be unmodifiable.
      */
     public PrintServiceAttributeSet getAttributes() {
 
         return attributes;
     }
-
 }