Re-merges with Classpath, from various people:

	* java/lang/Double.java (parseDouble): Fixed ordering of
	modifiers.
	* java/lang/reflect/AccessibleObject.java: Javadoc, reindented.
	* java/lang/reflect/Member.java: Reindented.
	* java/lang/reflect/Modifier.java: Reindented.
	(toString): Only trim trailing space if text was added to
	StringBuffer.
	* java/util/ConcurrentModificationException.java: Javadoc
	updates.
	* java/util/EmptyStackException.java: Likewise.
	* java/util/NoSuchElementException.java: Likewise.

From-SVN: r47018

3 files changed, 41 insertions, 14 deletions

diff --git a/libjava/java/util/ConcurrentModificationException.java b/libjava/java/util/ConcurrentModificationException.java
index 0f88c8f..364ba3b 100644
--- a/libjava/java/util/ConcurrentModificationException.java
+++ b/libjava/java/util/ConcurrentModificationException.java
@@ -30,7 +30,6 @@ package java.util;
 /* Written using "Java Class Libraries", 2nd edition, ISBN 0-201-31002-3
  * "The Java Language Specification", ISBN 0-201-63451-1
  * plus online API docs for JDK 1.2 beta from http://www.javasoft.com.
- * Status:  Believed complete and correct.
  */
 
 /**
@@ -38,15 +37,29 @@ package java.util;
  * a modification has been made to a data structure when this is not allowed,
  * such as when a collection is structurally modified while an Iterator is
  * operating over it. In cases where this can be detected, a
- * ConcurrentModificationException will be thrown. An Iterator that detects this
- * condition is referred to as fail-fast.
+ * ConcurrentModificationException will be thrown. An Iterator that detects
+ * this condition is referred to as fail-fast. Notice that this can occur
+ * even in single-threaded designs, if you call methods out of order.
  *
  * @author Warren Levy <warrenl@cygnus.com>
- * @date September 2, 1998.
+ * @author Eric Blake <ebb9@email.byu.edu>
+ * @see Collection
+ * @see Iterator
+ * @see ListIterator
+ * @see Vector
+ * @see LinkedList
+ * @see HashSet
+ * @see Hashtable
+ * @see TreeMap
+ * @see AbstractList
  * @since 1.2
+ * @status updated to 1.4
  */
 public class ConcurrentModificationException extends RuntimeException
 {
+  /**
+   * Compatible with JDK 1.2.
+   */
   private static final long serialVersionUID = -3666751008965953603L;
 
   /**
@@ -54,7 +67,6 @@ public class ConcurrentModificationException extends RuntimeException
    */
   public ConcurrentModificationException()
   {
-    super();
   }
 
   /**
diff --git a/libjava/java/util/EmptyStackException.java b/libjava/java/util/EmptyStackException.java
index a903d9d..2776206 100644
--- a/libjava/java/util/EmptyStackException.java
+++ b/libjava/java/util/EmptyStackException.java
@@ -30,7 +30,6 @@ package java.util;
 /* Written using "Java Class Libraries", 2nd edition, ISBN 0-201-31002-3
  * "The Java Language Specification", ISBN 0-201-63451-1
  * plus online API docs for JDK 1.2 beta from http://www.javasoft.com.
- * Status:  Believed complete and correct.
  */
 
 /**
@@ -38,10 +37,16 @@ package java.util;
  * or otherwise access elements from an empty stack.
  *
  * @author Warren Levy <warrenl@cygnus.com>
- * @date September 2, 1998.
+ * @author Eric Blake <ebb9@email.byu.edu>
+ * @see Stack
+ * @since 1.0
+ * @status updated to 1.4
  */
 public class EmptyStackException extends RuntimeException
 {
+  /**
+   * Compatible with JDK 1.0.
+   */
   private static final long serialVersionUID = 5084686378493302095L;
 
   /**
@@ -49,6 +54,5 @@ public class EmptyStackException extends RuntimeException
    */
   public EmptyStackException()
   {
-    super();
   }
 }
diff --git a/libjava/java/util/NoSuchElementException.java b/libjava/java/util/NoSuchElementException.java
index 5ca6544..3273dc0 100644
--- a/libjava/java/util/NoSuchElementException.java
+++ b/libjava/java/util/NoSuchElementException.java
@@ -30,20 +30,32 @@ package java.util;
 /* Written using "Java Class Libraries", 2nd edition, ISBN 0-201-31002-3
  * "The Java Language Specification", ISBN 0-201-63451-1
  * plus online API docs for JDK 1.2 beta from http://www.javasoft.com.
- * Status:  Believed complete and correct.
  */
 
 /**
  * Exception thrown when an attempt is made to access an element that does not
- * exist. This exception is thrown by the Enumeration, Iterator and ListIterator
- * classes if the nextElement, next or previous method goes beyond the end of
- * the list of elements that are being accessed.
+ * exist. This exception is thrown by the Enumeration, Iterator and
+ * ListIterator classes if the nextElement, next or previous method goes
+ * beyond the end of the list of elements that are being accessed. It is also
+ * thrown by Vector and Stack when attempting to access the first or last
+ * element of an empty collection.
  *
  * @author Warren Levy <warrenl@cygnus.com>
- * @date September 2, 1998.
+ * @author Eric Blake <ebb9@email.byu.edu>
+ * @see Enumeration
+ * @see Iterator
+ * @see ListIterator
+ * @see Enumeration#nextElement()
+ * @see Iterator#next()
+ * @see ListIterator#previous()
+ * @since 1.0
+ * @status updated to 1.4
  */
 public class NoSuchElementException extends RuntimeException
 {
+  /**
+   * Compatible with JDK 1.0.
+   */
   private static final long serialVersionUID = 6769829250639411880L;
 
   /**
@@ -51,7 +63,6 @@ public class NoSuchElementException extends RuntimeException
    */
   public NoSuchElementException()
   {
-    super();
   }
 
   /**