[commit-cp] classpath ChangeLog java/lang/annotation/Incomp... [generics]

[Andrew John Hughes]

CVSROOT:        /cvsroot/classpath
Module name:    classpath
Branch:         generics
Changes by:     Andrew John Hughes <gnu_andrew> 06/06/03 21:54:40

Modified files:
        .              : ChangeLog 
        java/lang/annotation: IncompleteAnnotationException.java 

Log message:
        2006-06-03  Andrew John Hughes  <[EMAIL PROTECTED]>
        
                * java/lang/annotation/IncompleteAnnotationException.java:
                Documented.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/classpath/ChangeLog?cvsroot=classpath&only_with_tag=generics&r1=1.2386.2.260&r2=1.2386.2.261
http://cvs.savannah.gnu.org/viewcvs/classpath/java/lang/annotation/IncompleteAnnotationException.java?cvsroot=classpath&only_with_tag=generics&r1=1.1.2.2&r2=1.1.2.3

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/classpath/classpath/ChangeLog,v
retrieving revision 1.2386.2.260
retrieving revision 1.2386.2.261
diff -u -b -r1.2386.2.260 -r1.2386.2.261
--- ChangeLog   3 Jun 2006 16:02:04 -0000       1.2386.2.260
+++ ChangeLog   3 Jun 2006 21:54:29 -0000       1.2386.2.261
@@ -1,5 +1,10 @@
 2006-06-03  Andrew John Hughes  <[EMAIL PROTECTED]>
 
+       * java/lang/annotation/IncompleteAnnotationException.java:
+       Documented.
+
+2006-06-03  Andrew John Hughes  <[EMAIL PROTECTED]>
+
        * java/lang/ProcessBuilder.java:
        Documented.
        (environment): Create as a copy.

Index: java/lang/annotation/IncompleteAnnotationException.java
===================================================================
RCS file: 
/cvsroot/classpath/classpath/java/lang/annotation/Attic/IncompleteAnnotationException.java,v
retrieving revision 1.1.2.2
retrieving revision 1.1.2.3
diff -u -b -r1.1.2.2 -r1.1.2.3
--- java/lang/annotation/IncompleteAnnotationException.java     21 Sep 2005 
21:32:39 -0000      1.1.2.2
+++ java/lang/annotation/IncompleteAnnotationException.java     3 Jun 2006 
21:54:40 -0000       1.1.2.3
@@ -38,10 +38,26 @@
 package java.lang.annotation;
 
 /**
+ * Thrown when accessing an element within an annotation which
+ * was added since compilation or serialization took place, and
+ * does not have a default value.  
+ * 
+ * @author Tom Tromey ([EMAIL PROTECTED])
+ * @author Andrew John Hughes ([EMAIL PROTECTED])
  * @since 1.5
  */
 public class IncompleteAnnotationException extends RuntimeException
 {
+
+  /**
+   * Constructs a new <code>IncompleteAnnotationException</code>
+   * which indicates that the element, <code>name</code>, was missing
+   * from the annotation, <code>type</code> at compile time and does
+   * not have a default value.
+   *
+   * @param type the type of annotation from which an element is missing.
+   * @param name the name of the missing element.
+   */
   public IncompleteAnnotationException(Class<? extends Annotation> type,
                                       String name)
   {
@@ -49,17 +65,43 @@
     this.elementName = name;
   }
 
+  /**
+   * Returns the class representing the type of annotation
+   * from which an element was missing.
+   *
+   * @return the type of annotation.
+   */
   public Class<? extends Annotation> annotationType()
   {
     return annotationType;
   }
 
+  /**
+   * Returns the name of the missing annotation element.
+   *
+   * @return the element name.
+   */
   public String elementName()
   {
     return elementName;
   }
 
   // Names are chosen from serialization spec.
+
+  /**
+   * The class representing the type of annotation from
+   * which an element was found to be missing.
+   *
+   * @serial the type of the annotation from which an
+   *         element was missing.
+   */
   private Class<? extends Annotation> annotationType;
+
+  /**
+   * The name of the missing element.
+   *
+   * @serial the name of the missing element. 
+   */
   private String elementName;
+
 }