From c6c340773c1e598bb45c9a32ff7c59078bb6403d Mon Sep 17 00:00:00 2001
From: Robert Pluim <rpluim@gmail.com>
Date: Fri, 17 Jan 2025 09:44:32 +0100
Subject: [PATCH] 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)
---
 lisp/keymap.el | 3 +++
 1 file changed, 3 insertions(+)

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)
 
-- 
2.39.5