(define-key-after): Clarify that the function is not useful for non-menu keymaps.

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index e9217fbe8ee0d6dedfc226fe475450c9168fb4b6..13bbd3cf60028f9f5dd6a68dbd2618bcecac5efd 100644 (file)
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,8 @@
 2011-10-06  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 
+       * subr.el (define-key-after): Clarify that the function is not
+       useful for non-menu keymaps.
+
        * progmodes/gdb-mi.el (gdb): Fix typo in doc string.
 
 2011-10-06  Thierry Volpiatto  <thierry.volpiatto@gmail.com>

diff --git a/lisp/subr.el b/lisp/subr.el
index 24e020acf09d032a6f4ad3a572983f88a8ef8231..05ac198dd13c38b7cf63c276aa644fd14a675936 100644 (file)
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -552,7 +552,8 @@ AFTER should be a single event type--a symbol or a character, not a sequence.
 
 Bindings are always added before any inherited map.
 
-The order of bindings in a keymap matters when it is used as a menu."
+The order of bindings in a keymap only matters when it is used as
+a menu, so this function is not useful for non-menu keymaps."
   (unless after (setq after t))
   (or (keymapp keymap)
       (signal 'wrong-type-argument (list 'keymapp keymap)))