master 732666b: define-key doc string improvement

[Lars Ingebrigtsen]

branch: master
commit 732666b86ec7c415a4d7246db3e9709a95bebf95
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    define-key doc string improvement
    
    * src/keymap.c (Fdefine_key): Explain what the STRING is used for.
    
    (local-set-key "\C-c\C-c"
               (define-keymap
                 :name "Zot"
                 "a" '("foo" . ignore)
                 "b" '("gazonk" . ignore)))
---
 src/keymap.c | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/src/keymap.c b/src/keymap.c
index be45d2b..5324f7f 100644
--- a/src/keymap.c
+++ b/src/keymap.c
@@ -1047,7 +1047,9 @@ DEF is anything that can be a key's definition:
     function definition, which should at that time be one of the above,
     or another symbol whose function definition is used, etc.),
  a cons (STRING . DEFN), meaning that DEFN is the definition
-    (DEFN should be a valid definition in its own right),
+    (DEFN should be a valid definition in its own right) and
+    STRING is the menu item name (which is used only if the containing
+    keymap has been created with a menu name, see `make-keymap'),
  or a cons (MAP . CHAR), meaning use definition of CHAR in keymap MAP,
  or an extended menu item definition.
  (See info node `(elisp)Extended Menu Items'.)