From: Robert Pluim <rpluim@gmail.com>
Date: Fri, 17 Jan 2025 08:44:32 +0000 (+0100)
Subject: Improve 'key-valid-p' docstring
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=c6c340773c1e598bb45c9a32ff7c59078bb6403d;p=emacs.git

Improve 'key-valid-p' docstring

* lisp/keymap.el (key-valid-p): Add "RET", "<return>", and "C-m"
examples.

(Bug#75586)

(cherry picked from commit 0e3687e6006ea93603a032056c6af99a242c6af5)
---

diff --git a/lisp/keymap.el b/lisp/keymap.el
index eb031d228dc..dc9bd9a8e20 100644
--- a/lisp/keymap.el
+++ b/lisp/keymap.el
@@ -335,6 +335,9 @@ Here are some example of valid key sequences.
   \"C-c o\"       (a two-key sequence: the key `c' with the control modifier
                  followed by the key `o')
   \"H-<left>\"    (the cursor control key named \"left\" with the hyper modifier)
+  \"RET\"         (the \"return\" key, also available as \"C-m\")
+  \"<return>\"    (the \"<return>\" function key, which can be bound separately
+                 from \"RET\" on some systems)
   \"M-RET\"       (the \"return\" key with a meta modifier)
   \"C-M-<space>\" (the \"space\" key with both the control and meta modifiers)