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

@@ -272,10 +272,14 @@
     }
 
     /**
      * 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,10 +377,14 @@
     /**
      * 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,10 +415,15 @@
     }
 
     /**
      * 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,10 +448,14 @@
         }
     }
 
     /**
      * 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