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-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=6d0289c3ecc94e8252b16f7f8e66a230b48939ae;p=emacs.git

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

(cherry picked from commit b392169e541a29178d7ae20f329d48b3d2bd78cf)
---

diff --git a/doc/lispref/commands.texi b/doc/lispref/commands.texi
index ea6e84e3730..e743038a778 100644
--- a/doc/lispref/commands.texi
+++ b/doc/lispref/commands.texi
@@ -3763,7 +3763,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