From: Stefan Kangas <stefan@marxist.se>
Date: Mon, 4 Jul 2022 14:02:26 +0000 (+0200)
Subject: * src/keymap.c (Fcopy_keymap): Document using defvar-keymap.
X-Git-Tag: emacs-29.0.90~1447^2~1196
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=599aea301283327a00e57a95c47148d28e93f1fc;p=emacs.git

* src/keymap.c (Fcopy_keymap): Document using defvar-keymap.
---

diff --git a/src/keymap.c b/src/keymap.c
index 2b77a7fc444..506b755e5da 100644
--- a/src/keymap.c
+++ b/src/keymap.c
@@ -1026,8 +1026,14 @@ DEFUN ("copy-keymap", Fcopy_keymap, Scopy_keymap, 1, 1, 0,
        doc: /* Return a copy of the keymap KEYMAP.
 
 Note that this is almost never needed.  If you want a keymap that's like
-another yet with a few changes, you should use map inheritance rather
-than copying.  I.e. something like:
+another yet with a few changes, you should use keymap inheritance rather
+than copying.  That is, something like:
+
+    (defvar-keymap foo-map
+      :parent <theirmap>
+      ...)
+
+Or, if you need to support Emacs versions older than 29:
 
     (let ((map (make-sparse-keymap)))
       (set-keymap-parent map <theirmap>)