summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStefan Monnier <monnier@iro.umontreal.ca>2020-04-10 17:04:19 -0400
committerStefan Monnier <monnier@iro.umontreal.ca>2020-04-10 17:04:19 -0400
commit6057d79a4eb4b95037068a1e9335a2418b2da5ec (patch)
tree4c918669925009dd3c40ab63f515a602c87e8a55
parent17a1bb5a032025d29413d5ad9316d3d001da3166 (diff)
downloademacs-6057d79a4eb4b95037068a1e9335a2418b2da5ec.tar.gz
* doc/lispref/keymaps.texi (Extended Menu Items): Tweak :key-sequence
Don't make it sound like `:key-sequence nil` is any different than the absence of `:key-sequence`. And the performance advantage of `:key-sequence` disappeared long ago.
-rw-r--r--doc/lispref/keymaps.texi16
1 files changed, 3 insertions, 13 deletions
diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index 259efea3248..f3c984848e7 100644
--- a/doc/lispref/keymaps.texi
+++ b/doc/lispref/keymaps.texi
@@ -2224,23 +2224,13 @@ set the variable so that the button you clicked on becomes selected.
@item :key-sequence @var{key-sequence}
This property specifies which key sequence is likely to be bound to the
-same command invoked by this menu item. If you specify the right key
-sequence, that makes preparing the menu for display run much faster.
+same command invoked by this menu item. If you specify a correct key
+sequence, that sequence will be preferred over others.
-If you specify the wrong key sequence, it has no effect; before Emacs
+If you specify in incorrect key sequence, it has no effect; before Emacs
displays @var{key-sequence} in the menu, it verifies that
@var{key-sequence} is really equivalent to this menu item.
-@item :key-sequence nil
-This property indicates that there is normally no key binding which is
-equivalent to this menu item. Using this property saves time in
-preparing the menu for display, because Emacs does not need to search
-the keymaps for a keyboard equivalent for this menu item.
-
-However, if the user has rebound this item's definition to a key
-sequence, Emacs ignores the @code{:keys} property and finds the keyboard
-equivalent anyway.
-
@item :keys @var{string}
This property specifies that @var{string} is the string to display
as the keyboard equivalent for this menu item. You can use