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

*** 1091,1101 ****
  
      /**
       * Hide this Window, its subcomponents, and all of its owned children.
       * The Window and its subcomponents can be made visible again
       * with a call to {@code show}.
-      * </p>
       * @see #show
       * @see #dispose
       * @deprecated As of JDK version 1.5, replaced by
       * {@link #setVisible(boolean)}.
       */
--- 1091,1100 ----
*** 3389,3419 ****
       * Calls to {@code setVisible}, {@code setLocation} and
       * {@code setBounds} after calling {@code setLocationByPlatform} clear
       * this property of the Window.
       * <p>
       * For example, after the following code is executed:
!      * <pre><blockquote>
       * setLocationByPlatform(true);
       * setVisible(true);
       * boolean flag = isLocationByPlatform();
!      * </blockquote></pre>
       * The window will be shown at platform's default location and
       * {@code flag} will be {@code false}.
       * <p>
       * In the following sample:
!      * <pre><blockquote>
       * setLocationByPlatform(true);
       * setLocation(10, 10);
       * boolean flag = isLocationByPlatform();
       * setVisible(true);
!      * </blockquote></pre>
       * The window will be shown at (10, 10) and {@code flag} will be
       * {@code false}.
       *
       * @param locationByPlatform {@code true} if this Window should appear
       *        at the default location, {@code false} if at the current location
!      * @throws {@code IllegalComponentStateException} if the window
       *         is showing on screen and locationByPlatform is {@code true}.
       * @see #setLocation
       * @see #isShowing
       * @see #setVisible
       * @see #isLocationByPlatform
--- 3388,3418 ----
       * Calls to {@code setVisible}, {@code setLocation} and
       * {@code setBounds} after calling {@code setLocationByPlatform} clear
       * this property of the Window.
       * <p>
       * For example, after the following code is executed:
!      * <pre>
       * setLocationByPlatform(true);
       * setVisible(true);
       * boolean flag = isLocationByPlatform();
!      * </pre>
       * The window will be shown at platform's default location and
       * {@code flag} will be {@code false}.
       * <p>
       * In the following sample:
!      * <pre>
       * setLocationByPlatform(true);
       * setLocation(10, 10);
       * boolean flag = isLocationByPlatform();
       * setVisible(true);
!      * </pre>
       * The window will be shown at (10, 10) and {@code flag} will be
       * {@code false}.
       *
       * @param locationByPlatform {@code true} if this Window should appear
       *        at the default location, {@code false} if at the current location
!      * @throws IllegalComponentStateException if the window
       *         is showing on screen and locationByPlatform is {@code true}.
       * @see #setLocation
       * @see #isShowing
       * @see #setVisible
       * @see #isLocationByPlatform