diff --git a/src/share/classes/javax/swing/text/Keymap.java b/src/share/classes/javax/swing/text/Keymap.java
index 082d7707e440b67ecbee625a83fe2c6ee5f98c01..cf503b0f3358bdd508c9cb9e5a6fae55fb420f69 100644
--- a/src/share/classes/javax/swing/text/Keymap.java
+++ b/src/share/classes/javax/swing/text/Keymap.java
@@ -137,6 +137,8 @@ public interface Keymap {
     /**
      * Sets the parent keymap, which will be used to
      * resolve key-bindings.
+     * The behavior is unspecified if a {@code Keymap} has itself
+     * as one of its resolve parents.
      *
      * @param parent the parent keymap
      */