]> git.eshelyaron.com Git - emacs.git/commitdiff
* src/keymap.c (Fcopy_keymap): Document using defvar-keymap.
authorStefan Kangas <stefan@marxist.se>
Mon, 4 Jul 2022 14:02:26 +0000 (16:02 +0200)
committerStefan Kangas <stefan@marxist.se>
Mon, 4 Jul 2022 15:01:53 +0000 (17:01 +0200)
src/keymap.c

index 2b77a7fc444c401da698a8b7269169c2d77e483b..506b755e5dad3fb0bae15a4fdb9deefe67a74d8c 100644 (file)
@@ -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>)