Doc fix for `kbd'

* lisp/subr.el (kbd): Describe more fully the format of the
parameter (bug#17039).

diff --git a/lisp/subr.el b/lisp/subr.el
index 2dfd96edc07c1a89dab9bf20d35b831ada888065..6cc2585122c198d4d49d2b1f711e4af81cbbd218 100644 (file)
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -620,8 +620,10 @@ side-effects, and the argument LIST is not modified."
 
 (defun kbd (keys)
   "Convert KEYS to the internal Emacs key representation.
-KEYS should be a string constant in the format used for
-saving keyboard macros (see `edmacro-mode')."
+KEYS should be a string in the format returned by commands such
+as `C-h k' (`describe-key').
+This is the same format used for saving keyboard macros (see
+`edmacro-mode')."
   ;; Don't use a defalias, since the `pure' property is only true for
   ;; the calling convention of `kbd'.
   (read-kbd-macro keys))