Consistent terminology and more details in comments.

beldenfox · Feb 9, 2024 · 6400299 · 6400299
1 parent 8f23817
commit 6400299
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 8 deletions.
diff --git a/modules/javafx.graphics/src/main/java/com/sun/glass/events/KeyEvent.java b/modules/javafx.graphics/src/main/java/com/sun/glass/events/KeyEvent.java
@@ -251,10 +251,11 @@ public class KeyEvent {
     /**
      * Returns a VK_ code of a key capable of producing the given unicode
      * character with respect to the currently active keyboard layout or
-     * VK_UNDEFINED if the character isn't present in the current layout.
-     * The hint is the KeyCode of the key the system is attempting to match.
-     * It can be used to optimize the search or to distinguish between the
-     * main keyboard and the numeric keypad.
+     * VK_UNDEFINED if the character isn't present in the current layout. The
+     * hint is the VK_ code of the key the system is attempting to match
+     * (which may be VK_UNDEFINED for a key on the main keyboard). It can be
+     * used to optimize the search or to distinguish between the main
+     * keyboard and the numeric keypad.
      *
      * @param c the character
      * @param hint the code of the key the system is attempting to match

diff --git a/modules/javafx.graphics/src/main/java/com/sun/glass/ui/Application.java b/modules/javafx.graphics/src/main/java/com/sun/glass/ui/Application.java
@@ -727,10 +727,11 @@ public final boolean supportsSystemMenu() {
     /**
      * Returns a VK_ code of a key capable of producing the given unicode
      * character with respect to the currently active keyboard layout or
-     * VK_UNDEFINED if the character isn't present in the current layout.
-     * The hint is the KeyCode of the key the system is attempting to match.
-     * It can be used to optimize the search or to distinguish between the
-     * main keyboard and the numeric keypad.
+     * VK_UNDEFINED if the character isn't present in the current layout. The
+     * hint is the VK_ code of the key the system is attempting to match
+     * (which may be VK_UNDEFINED for a key on the main keyboard). It can be
+     * used to optimize the search or to distinguish between the main
+     * keyboard and the numeric keypad.
      *
      * @param c the character
      * @param hint the code of the key the system is attempting to match