From: Lars Ingebrigtsen <larsi@gnus.org>
Date: Fri, 11 Oct 2019 20:28:27 +0000 (+0200)
Subject: Document REAL-BINDING more extensively in Extended Menu Items
X-Git-Tag: archive/raspbian/1%29.2+1-2+rpi1^2~5^2~19^2~1532
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=f9d8babe6a28b19c781778c361e45b93f7a01f17;p=emacs.git

Document REAL-BINDING more extensively in Extended Menu Items

* doc/lispref/keymaps.texi (Extended Menu Items): Document that
REAL-BINDING can be other things than a real command (bug#7755).
---

diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index 58f4a6687d9..532e537026a 100644
--- a/doc/lispref/keymaps.texi
+++ b/doc/lispref/keymaps.texi
@@ -2152,10 +2152,16 @@ binding looks like this:
 
 @noindent
 Here, @var{item-name} is an expression which evaluates to the menu item
-string.  Thus, the string need not be a constant.  The third element,
-@var{real-binding}, is the command to execute.  The tail of the list,
-@var{item-property-list}, has the form of a property list which contains
-other information.
+string.  Thus, the string need not be a constant.
+
+The third element, @var{real-binding}, can be the command to execute
+(in which case you get a normal menu item).  It can also be a keymap,
+which will result in a submenu.  Finally, it can be @code{nil}, in
+which case you will get a non-selectable menu item.  This is mostly
+useful when creating separator lines and the like.
+
+The tail of the list, @var{item-property-list}, has the form of a
+property list which contains other information.
 
   Here is a table of the properties that are supported: