[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
emacs-29 6bf441ff115: Warn package authors away from keymap-unset with R
From: |
Robert Pluim |
Subject: |
emacs-29 6bf441ff115: Warn package authors away from keymap-unset with REMOVE |
Date: |
Mon, 20 Mar 2023 11:27:31 -0400 (EDT) |
branch: emacs-29
commit 6bf441ff11540f2c49cb4f9d506597217cdc73d6
Author: Robert Pluim <rpluim@gmail.com>
Commit: Robert Pluim <rpluim@gmail.com>
Warn package authors away from keymap-unset with REMOVE
* doc/lispref/keymaps.texi (Changing Key Bindings): Ask package
authors to not use the REMOVE argument to `keymap-unset'.
---
doc/lispref/keymaps.texi | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index c17c8a2dc3f..0eea696c612 100644
--- a/doc/lispref/keymaps.texi
+++ b/doc/lispref/keymaps.texi
@@ -1452,6 +1452,12 @@ keymap; using @var{remove} instead will allow the key in
the parent keymap
to be used.
@end defun
+Note: using @code{keymap-unset} with @var{remove} non-@code{nil} is
+intended for users to put in their init file; Emacs packages should
+avoid using it if possible, since they have complete control over
+their own keymaps anyway, and they should not be altering other
+packages' keymaps.
+
This example creates a sparse keymap and makes a number of
bindings in it:
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- emacs-29 6bf441ff115: Warn package authors away from keymap-unset with REMOVE,
Robert Pluim <=