1 files changed, 28 insertions, 2 deletions

diff --git a/libjava/java/awt/EventQueue.java b/libjava/java/awt/EventQueue.java
index 1ce3d163181..6b64fb7ee3b 100644
--- a/libjava/java/awt/EventQueue.java
+++ b/libjava/java/awt/EventQueue.java
@@ -151,6 +151,8 @@ public class EventQueue
    * Posts a new event to the queue.
    *
    * @param event The event to post to the queue.
+   *
+   * @exception NullPointerException If event is null.
    */
   public synchronized void postEvent(AWTEvent evt)
   {
@@ -209,7 +211,19 @@ public class EventQueue
     notify();
   }
 
-  /** @since JDK1.2 */
+  /**
+   * Causes runnable to have its run method called in the dispatch thread of the
+   * EventQueue. This will happen after all pending events are processed. The
+   * call blocks until this has happened. This method will throw an Error if
+   * called from the event dispatcher thread.
+   *
+   * @exception InterruptedException If another thread has interrupted
+   * this thread.
+   * @exception InvocationTargetException If an exception is thrown when running
+   * runnable.
+   *
+   * @since 1.2
+   */
   public static void invokeAndWait(Runnable runnable)
     throws InterruptedException, InvocationTargetException
   {
@@ -254,6 +268,8 @@ public class EventQueue
     * All pending events are transferred to the new queue. Calls to postEvent,
     * getNextEvent, and peekEvent are forwarded to the pushed queue until it
     * is removed with a pop().
+    *
+    * @exception NullPointerException if newEventQueue is null.
     */
   public synchronized void push(EventQueue newEventQueue)
   {
@@ -271,7 +287,11 @@ public class EventQueue
   }
 
   /** Transfer any pending events from this queue back to the parent queue that
-    * was previously push()ed. Event dispatch from this queue is suspended. */
+    * was previously push()ed. Event dispatch from this queue is suspended.
+    *
+    * @exception EmptyStackException If no previous push was made on this
+    * EventQueue.
+    */
   protected void pop() throws EmptyStackException
   {
     if (prev == null)
@@ -297,6 +317,12 @@ public class EventQueue
       }
   }
 
+  /**
+   * Dispatches an event. The manner in which the event is dispatched depends
+   * upon the type of the event and the type of the event's source object.
+   *
+   * @exception NullPointerException If event is null.
+   */
   protected void dispatchEvent(AWTEvent evt)
   {
     if (evt instanceof ActiveEvent)