From: Eli Zaretskii <eliz@gnu.org>
Date: Thu, 2 May 2024 09:20:09 +0000 (+0300)
Subject: ; * doc/lispref/commands.texi (Event Mod): Add motivation (bug#70596).
X-Git-Tag: archive/raspbian/1%29.4+1-4+rpi1~1^2~2^2~17^2~43
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=b392169e541a29178d7ae20f329d48b3d2bd78cf;p=emacs.git

; * doc/lispref/commands.texi (Event Mod): Add motivation (bug#70596).
---

diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index dfb20cd807b..82bc6834142 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -3420,7 +3420,10 @@ character as far as keyboard translation is concerned, but it has the
 same usual meaning.
 
   @xref{Translation Keymaps}, for mechanisms that translate event sequences
-at the level of @code{read-key-sequence}.
+at the level of @code{read-key-sequence}.  If you need to translate
+input events that are not characters (i.e., @code{characterp} returns
+@code{nil} for them), you must use the event translation mechanism
+described there.
 
 @node Invoking the Input Method
 @subsection Invoking the Input Method