1 files changed, 23 insertions, 4 deletions
diff --git a/libjava/classpath/javax/print/event/PrintJobEvent.java b/libjava/classpath/javax/print/event/PrintJobEvent.java
index c4b7cd6f942..cc15f97535b 100644
--- a/libjava/classpath/javax/print/event/PrintJobEvent.java
+++ b/libjava/classpath/javax/print/event/PrintJobEvent.java
@@ -1,5 +1,5 @@
 /* PrintEvent.java -- 
-   Copyright (C) 2004  Free Software Foundation, Inc.
+   Copyright (C) 2004, 2005  Free Software Foundation, Inc.
 
 This file is part of GNU Classpath.
 
@@ -41,19 +41,38 @@ import javax.print.DocPrintJob;
 
 
 /**
+ * <code>PrintJobEvent</code>s are generated by a print job during
+ * print job processing to inform registered listeners about the state
+ * of processing.
+ * 
  * @author Michael Koch (konqueror@gmx.de)
  */
 public class PrintJobEvent extends PrintEvent
 {
   private static final long serialVersionUID = -1711656903622072997L;
-
+  
+  /** Indicates that the data transfer to the print service has completed. */
   public static final int DATA_TRANSFER_COMPLETE = 106;
+  
+  /** Indicates that the print job was canceled. */
   public static final int JOB_CANCELED = 101;
+  
+  /** Indicates that the print job was completed (=printed). */
   public static final int JOB_COMPLETE = 102;
+  
+  /** Indicates that the print job failed to complete. */
   public static final int JOB_FAILED = 103;
+  
+  /** Indicates that no more job events will be send.*/
   public static final int NO_MORE_EVENTS = 105;
+  
+  /** 
+   * Indicates a situation where human intervention might be needed.
+   * E.g. the printer run out of paper or a paper jam occured.
+   */
   public static final int REQUIRES_ATTENTION = 104;
   
+  /** The reason (one of the defined constants). */
   private int reason;
   
   /**
@@ -71,7 +90,7 @@ public class PrintJobEvent extends PrintEvent
   /**
    * Returns the reason for this event.
    * 
-   * @return the reason
+   * @return The reason.
    */
   public int getPrintEventType()
   {
@@ -81,7 +100,7 @@ public class PrintJobEvent extends PrintEvent
   /**
    * Returns the print job that generated this event.
    * 
-   * @return the print job
+   * @return The print job.
    */ 
   public DocPrintJob getPrintJob()
   {