Subject: 24.3.50; doc string of `insert-kbd-macro'

From: Drew Adams <[email-masked]>
Date: Sun, 1 Dec 2013 19:35:52 -0800 (PST)

Doc string:

 (insert-kbd-macro MACRONAME &optional KEYS)

 Insert in buffer the definition of kbd macro NAME, as Lisp code.

1. Uh, no.  Choose one or the other: MACRONAME or NAME.

2. Say what NAME/MACRONAME is: a symbol.  NAME as an argument in Emacs
often means a string, and anyway, a Lisp user won't know which you mean.

Consider calling it SYMBOL:

 (insert-kbd-macro SYMBOL &optional KEYS)

 Insert the definition of the kbd macro named SYMBOL, as Lisp code.

This would also be in keeping with `name-last-kbd-macro' and
`kmacro-name-last-macro':

 (name-last-kbd-macro SYMBOL)

 Assign a name to the last keyboard macro defined.
 Argument SYMBOL is the name to define.

 (kmacro-name-last-macro SYMBOL)

 Assign a name to the last keyboard macro defined.
 Argument SYMBOL is the name to define.

In GNU Emacs 24.3.50.2 (i686-pc-mingw32)
 of 2013-11-28 on LEG570
Bzr revision: 115271 [email-masked]
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking 'CFLAGS=-O0 -g3' CPPFLAGS=-DGLYPH_DEBUG=1'