(Using Interactive): Document interactive-form.

(Keyboard Macros): Document kbd-macro-termination-hook.
(Command Loop Info): Document that clear-this-command-keys clears
the vector to be returned by recent-keys.

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index 6d77cc9..9bc1383 100644 (file)
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,3 +1,62 @@
+2001-09-08  Eli Zaretskii  <eliz@is.elta.co.il>
+
+       * strings.texi (String Conversion) <string-to-number>: Document
+       that a float is returned for integers that are too large.
+
+       * frames.texi (Mouse Position): Document mouse-position-function.
+       (Display Feature Testing): Document display-images-p.
+       (Window Frame Parameters): Document the cursor-type variable.
+
+       * numbers.texi (Integer Basics): Document CL style read syntax for
+       integers in bases other than 10.
+
+       * positions.texi (List Motion): Document
+       open-paren-in-column-0-is-defun-start.
+
+       * lists.texi (Sets And Lists): Document member-ignore-case.
+
+       * internals.texi (Garbage Collection): Document the used and free
+       strings report.
+       (Memory Usage): Document strings-consed.
+
+       * os.texi (Time of Day): Document float-time.
+       (Recording Input): Document that clear-this-command-keys clears
+       the vector to be returned by recent-keys.
+
+       * keymaps.texi (Scanning Keymaps) <where-is-internal>: The
+       argument keymap can be a list.
+
+       * nonascii.texi (User-Chosen Coding Systems)
+       <select-safe-coding-system>: Document the new argument
+       accept-default-p and the variable
+       select-safe-coding-system-accept-default-p.  Tell what happens if
+       buffer-file-coding-system is undecided.
+       (Default Coding Systems): Document auto-coding-regexp-alist.
+
+       * display.texi (The Echo Area) <message>: Document
+       message-truncate-lines.
+       (Glyphs): Document that the glyph table is unused on windowed
+       displays.
+
+       * help.texi (Describing Characters) <single-key-description>:
+       Document the new argument no-angles.
+       (Accessing Documentation) <documentation-property>: Document that
+       a non-string property is evaluated.
+       <documentation>: Document that the function-documentation property
+       is looked for.
+
+       * windows.texi (Selecting Windows): Document some-window.
+
+       * text.texi (MD5 Checksum): New node, documents the md5 primitive.
+
+       * hooks.texi (Standard Hooks): Add kbd-macro-termination-hook and
+       apropos-mode-hook.
+
+       * commands.texi (Using Interactive): Document interactive-form.
+       (Keyboard Macros): Document kbd-macro-termination-hook.
+       (Command Loop Info): Document that clear-this-command-keys clears
+       the vector to be returned by recent-keys.
+
 2001-09-04  Werner LEMBERG  <wl@gnu.org>
 
        * Makefile.in (srcdir, texinputdir): New variables.

diff --git a/lispref/commands.texi b/lispref/commands.texi
index 4a204f5..5882f26 100644 (file)
--- a/lispref/commands.texi
+++ b/lispref/commands.texi
@@ -114,7 +114,8 @@ controls the reading of arguments for an interactive call.
 @subsection Using @code{interactive}
 
   This section describes how to write the @code{interactive} form that
-makes a Lisp function an interactively-callable command.
+makes a Lisp function an interactively-callable command, and how to
+obtain the interactive form of a command.
 
 @defspec interactive arg-descriptor
 @cindex argument descriptors
@@ -228,6 +229,17 @@ string (starting with the first character that is not @samp{*} or
 @samp{@@}).
 @end itemize
 
+@cindex obtaining interactive form of a function
+@defun interactive-form function
+This function returns the interactive form of @var{function}.  If
+@var{function} is a command (@pxref{Interactive Call}), the value is a
+list of the form @code{(interactive @var{spec})}, where @var{spec} is
+the descriptor specification used by the command's @code{interactive}
+form to compute the function's arguments (@pxref{Using Interactive}).
+If @var{function} is not a command, @code{interactive-form} returns
+@code{nil}.
+@end defun
+
 @node Interactive Codes
 @comment  node-name,  next,  previous,  up
 @subsection Code Characters for @code{interactive}
@@ -735,9 +747,11 @@ input events in a string (@pxref{Strings of Events}).
 @tindex clear-this-command-keys
 @defun clear-this-command-keys
 This function empties out the table of events for
-@code{this-command-keys} to return.  This is useful after reading a
-password, to prevent the password from echoing inadvertently as part of
-the next command in certain cases.
+@code{this-command-keys} to return, and also cause the function
+@code{recent-keys} (@pxref{Recording Input}) to return an empty
+vector.  This is useful after reading a password, to prevent the
+password from echoing inadvertently as part of the next command in
+certain cases.
 @end defun
 
 @defvar last-nonmenu-event
@@ -2776,3 +2790,8 @@ The variable is always local to the current terminal and cannot be
 buffer-local.  @xref{Multiple Displays}.
 @end defvar
 
+@defvar kbd-macro-termination-hook
+This normal hook (@pxref{Standard Hooks}) is run when a keyboard
+macro terminates, regardless of what caused it to terminate (reaching
+the macro end or an error which ended the macro prematurely).
+@end defvar