docs: Clarified definition of KeyEvent.Callback.onKeyMultiple() am: b248b1f689

am: f3f234ff36

Change-Id: I2c86132a817e6629435baaaa5a525ea828b6848d

core/java/android/view/KeyEvent.java

@@ -1289,8 +1289,9 @@ public class KeyEvent extends InputEvent implements Parcelable {
         boolean onKeyUp(int keyCode, KeyEvent event);
 
         /**
-         * Called when multiple down/up pairs of the same key have occurred
-         * in a row.
+         * Called when a user's interaction with an analog control, such as
+         * flinging a trackball, generates simulated down/up events for the same
+         * key multiple times in quick succession.
          *
          * @param keyCode The value in event.getKeyCode().
          * @param count Number of pairs as returned by event.getRepeatCount().