procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

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

Browse source
This commit is contained in:
Stefan Kangas 2022-07-04 16:02:26 +02:00
parent cfc754a67c
commit 599aea3012
1 changed files with 8 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
src/keymap.c
View 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>)