src/share/classes/java/awt/Window.java

@@ -1,7 +1,7 @@
 /*
- * Copyright (c) 1995, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2014, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
  * under the terms of the GNU General Public License version 2 only, as
  * published by the Free Software Foundation.  Oracle designates this

@@ -1450,10 +1450,12 @@
         super.setCursor(cursor);
     }
 
     /**
      * Returns the owner of this window.
+     *
+     * @return the owner of this window
      * @since 1.2
      */
     public Window getOwner() {
         return getOwner_NoClientCode();
     }

@@ -1462,10 +1464,12 @@
     }
 
     /**
      * Return an array containing all the windows this
      * window currently owns.
+     *
+     * @return the array of all the owned windows
      * @since 1.2
      */
     public Window[] getOwnedWindows() {
         return getOwnedWindows_NoClientCode();
     }

@@ -1584,10 +1588,11 @@
      * as a print dialog. Applications should not assume the existence of
      * these dialogs, nor should an application assume anything about these
      * dialogs such as component positions, {@code LayoutManager}s
      * or serialization.
      *
+     * @return the array of all the {@code Window}s created by the application
      * @see Frame#getFrames
      * @see Window#getOwnerlessWindows
      *
      * @since 1.6
      */

@@ -1606,10 +1611,12 @@
      * as a print dialog. Applications should not assume the existence of
      * these dialogs, nor should an application assume anything about these
      * dialogs such as component positions, {@code LayoutManager}s
      * or serialization.
      *
+     * @return the array of all the ownerless {@code Window}s
+     *         created by this application
      * @see Frame#getFrames
      * @see Window#getWindows()
      *
      * @since 1.6
      */

@@ -2847,10 +2854,11 @@
     /**
      * Sets the type of the window.
      *
      * This method can only be called while the window is not displayable.
      *
+     * @param  type the window type
      * @throws IllegalComponentStateException if the window
      *         is displayable.
      * @throws IllegalArgumentException if the type is {@code null}
      * @see    Component#isDisplayable
      * @see    #getType

@@ -2872,10 +2880,11 @@
     }
 
     /**
      * Returns the type of the window.
      *
+     * @return the type of the window
      * @see   #setType
      * @since 1.7
      */
     public Type getType() {
         synchronized (getObjectLock()) {