src/java.desktop/share/classes/java/awt/Taskbar.java

*** 272,281 ****
--- 272,285 ----
      }
  
      /**
       * Requests user attention to the specified window.
       *
+      * Has no effect if a window representation is not displayable in 
+      * the task area. Whether it is displayable is dependent on all 
+      * of window type, platform, and implementation.
+      *
       * @param w window
       * @throws SecurityException if a security manager exists and it denies the
       * {@code RuntimePermission("canProcessApplicationEvents")} permission.
       * @throws UnsupportedOperationException if the current platform
       * does not support the {@link Taskbar.Feature#USER_ATTENTION_WINDOW} feature
*** 373,382 ****
--- 377,390 ----
      /**
       * Affixes a small badge to this application's icon in the task area
       * for the specified window.
       * It may be disabled by system settings.
       *
+      * Has no effect if a window representation is not displayable in 
+      * the task area. Whether it is displayable is dependent on all 
+      * of window type, platform, and implementation.
+      *
       * @param w window to update
       * @param badge image to affix to the icon
       * @throws SecurityException if a security manager exists and it denies the
       * {@code RuntimePermission("canProcessApplicationEvents")} permission.
       * @throws UnsupportedOperationException if the current platform
*** 407,416 ****
--- 415,429 ----
      }
  
      /**
       * Displays a determinate progress bar in the task area for the specified
       * window.
+      *
+      * Has no effect if a window representation is not displayable in 
+      * the task area. Whether it is displayable is dependent on all 
+      * of window type, platform, and implementation.
+      * 
       * <br>
       * The visual behavior is platform and {@link State} dependent.
       * <br>
       * This call cancels the {@link State#INDETERMINATE INDETERMINATE} state
       * of the window.
*** 435,444 ****
--- 448,461 ----
          }
      }
  
      /**
       * Sets a progress state for a specified window.
+      *
+      * Has no effect if a window representation is not displayable in 
+      * the task area. Whether it is displayable is dependent on all 
+      * of window type, platform, and implementation.
       * <br>
       * Each state displays a progress in a platform-dependent way.
       * <br>
       * Note than switching from {@link State#INDETERMINATE INDETERMINATE} state
       * to any of determinate states may reset value set by