src/share/classes/java/awt/Component.java

*** 7167,7176 ****
--- 7167,7180 ----
       * <p>
       * If a value of null is specified for the Set, this Component inherits the
       * Set from its parent. If all ancestors of this Component have null
       * specified for the Set, then the current KeyboardFocusManager's default
       * Set is used.
+      * <p>
+      * This method may throw a {@code ClassCastException} if any 
+      * {@code Object} in {@code keystrokes} is not an 
+      * {@code AWTKeyStroke}.
       *
       * @param id one of KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
       *        KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, or
       *        KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS
       * @param keystrokes the Set of AWTKeyStroke for the specified operation
*** 7180,7191 ****
       * @see KeyboardFocusManager#UP_CYCLE_TRAVERSAL_KEYS
       * @throws IllegalArgumentException if id is not one of
       *         KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
       *         KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, or
       *         KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or if keystrokes
!      *         contains null, or if any Object in keystrokes is not an
!      *         AWTKeyStroke, or if any keystroke represents a KEY_TYPED event,
       *         or if any keystroke already maps to another focus traversal
       *         operation for this Component
       * @since 1.4
       * @beaninfo
       *       bound: true
--- 7184,7194 ----
       * @see KeyboardFocusManager#UP_CYCLE_TRAVERSAL_KEYS
       * @throws IllegalArgumentException if id is not one of
       *         KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS,
       *         KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, or
       *         KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, or if keystrokes
!      *         contains null, or if any keystroke represents a KEY_TYPED event,
       *         or if any keystroke already maps to another focus traversal
       *         operation for this Component
       * @since 1.4
       * @beaninfo
       *       bound: true