[Emacs-diffs] master f9d8bab: Document REAL-BINDING more extensively in Extended Menu Items

[Lars Ingebrigtsen]

branch: master
commit f9d8babe6a28b19c781778c361e45b93f7a01f17
Author: Lars Ingebrigtsen <address@hidden>
Commit: Lars Ingebrigtsen <address@hidden>

    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).
---
 doc/lispref/keymaps.texi | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi
index 58f4a66..532e537 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: