[Emacs-diffs] Changes to emacs/lispref/commands.texi

[Richard M. Stallman]

Index: emacs/lispref/commands.texi
diff -c emacs/lispref/commands.texi:1.40 emacs/lispref/commands.texi:1.41
*** emacs/lispref/commands.texi:1.40    Tue Aug  5 21:12:49 2003
--- emacs/lispref/commands.texi Wed Aug 13 13:19:36 2003
***************
*** 503,509 ****
  @code{call-interactively}, which reads the arguments and calls the
  command.  You can also call these functions yourself.
  
! @defun commandp object
  Returns @code{t} if @var{object} is suitable for calling interactively;
  that is, if @var{object} is a command.  Otherwise, returns @code{nil}.
  
--- 503,509 ----
  @code{call-interactively}, which reads the arguments and calls the
  command.  You can also call these functions yourself.
  
! @defun commandp object &optional for-call-interactively
  Returns @code{t} if @var{object} is suitable for calling interactively;
  that is, if @var{object} is a command.  Otherwise, returns @code{nil}.
  
***************
*** 514,524 ****
  (address@hidden fourth argument to @code{autoload}), and some of the
  primitive functions.
  
! A symbol satisfies @code{commandp} if its function definition satisfies
! @code{commandp}.
! 
! Keys and keymaps are not commands.  Rather, they are used to look up
! commands (@pxref{Keymaps}).
  
  See @code{documentation} in @ref{Accessing Documentation}, for a
  realistic example of using @code{commandp}.
--- 514,526 ----
  (address@hidden fourth argument to @code{autoload}), and some of the
  primitive functions.
  
! A symbol satisfies @code{commandp} if its function definition
! satisfies @code{commandp}.  Keys and keymaps are not commands.
! Rather, they are used to look up commands (@pxref{Keymaps}).
! 
! If @var{for-call-interactively} is address@hidden, then
! @code{commandp} returns @code{t} only for objects that
! @code{call-interactively} could call---thus, not for keyboard macros.
  
  See @code{documentation} in @ref{Accessing Documentation}, for a
  realistic example of using @code{commandp}.
***************
*** 730,735 ****
--- 732,745 ----
  We do not bind @code{this-command} with @code{let} because that would
  restore the old value in case of error---a feature of @code{let} which
  in this case does precisely what we want to avoid.
+ 
+ @defvar this-original-command
+ This has the same value as @code{this-command} except when command
+ remapping occurs (@pxref{Remapping Commands}).  In that case,
+ @code{this-command} gives the command actually run (the result of
+ remapping), and @code{this-original-command} gives the command that
+ was specified to run but remapped into another command.
+ @end defvar
  
  @defun this-command-keys
  This function returns a string or vector containing the key sequence