1 files changed, 4 insertions, 0 deletions
diff --git a/core/events.lua b/core/events.lua
index 3ee2e333..0953f2f1 100644
--- a/core/events.lua
+++ b/core/events.lua
@@ -67,11 +67,14 @@ local M = {}
 --   * `ch`: The text character byte.
 -- @field COMMAND_ENTRY_COMMAND (string)
 --   Called when a command is entered into the Command Entry.
+--   If any handler returns `true`, the Command Entry does not hide
+--   automatically.
 --   Arguments:
 --
 --   * `command`: The command text.
 -- @field COMMAND_ENTRY_KEYPRESS (string)
 --   Called when a key is pressed in the Command Entry.
+--   If any handler returns `true`, the key is not inserted into the entry.
 --   Arguments:
 --
 --   * `code`: The key code.
@@ -176,6 +179,7 @@ local M = {}
 --   * `position`: The text position of the release.
 -- @field KEYPRESS (string)
 --   Called when a key is pressed.
+--   If any handler returns `true`, the key is not inserted into the buffer.
 --   Arguments:
 --
 --   * `code`: The key code.