[cp-patches] java.lang.Class.newInstance: Doc fix patch

[Steven Augart]

I request feedback on thefollowing patch.  This patch fixes a doc bug
in java.lang.Class.  I intend to commit it with the following
ChangeLog entry:

2004-09-23  Steven Augart  <address@hidden>

        * java/lang/Class.java (newInstance): Doc fix.


Index: java/lang/Class.java
===================================================================
RCS file: /cvsroot/classpath/classpath/java/lang/Class.java,v
retrieving revision 1.23
diff -I*.class -u -r1.23 Class.java
--- java/lang/Class.java        17 Aug 2004 03:15:19 -0000      1.23
+++ java/lang/Class.java        23 Sep 2004 20:49:53 -0000
@@ -1075,13 +1075,19 @@
    * @return a new instance of this class
    * @throws InstantiationException if there is not a no-arg constructor
    *         for this class, including interfaces, abstract classes, arrays,
-   *         primitive types, and void; or if an exception occurred during
-   *         the constructor
+   *         primitive types, and void
    * @throws IllegalAccessException if you are not allowed to access the
    *         no-arg constructor because of scoping reasons
    * @throws SecurityException if the security check fails
    * @throws ExceptionInInitializerError if class initialization caused by
    *         this call fails with an exception
+   * @throws Any other exception that occurs while the constructor is
+   *         running.  (It is a regrettable bug in the language.  That's the
+   *         behavior, as documented in Sun's JDK 1.5.0rc1 documentation for
+   *         java.lang.Class.  This was discused on the Classpath mailing
+   *         list; see
+   *         
<tt>http://lists.gnu.org/archive/html/classpath/2004-09/index.html</tt> 
+   *         and search for "newInstance".)
    */
   public Object newInstance()
     throws InstantiationException, IllegalAccessException