command-execute doc string clarification

* lisp/simple.el (command-execute): Doc string clarification
(bug#43749).
This commit is contained in:
Boruch Baum 2020-10-01 20:26:13 +02:00 committed by Lars Ingebrigtsen
parent d00eb41fc2
commit cd8880514f

View file

@ -2067,13 +2067,18 @@ invoking, give a prefix argument to `execute-extended-command'."
;; BEWARE: Called directly from the C code.
"Execute CMD as an editor command.
CMD must be a symbol that satisfies the `commandp' predicate.
Optional second arg RECORD-FLAG non-nil
means unconditionally put this command in the variable `command-history'.
Otherwise, that is done only if an arg is read using the minibuffer.
The argument KEYS specifies the value to use instead of (this-command-keys)
when reading the arguments; if it is nil, (this-command-keys) is used.
The argument SPECIAL, if non-nil, means that this command is executing
a special event, so ignore the prefix argument and don't clear it."
Optional second arg RECORD-FLAG non-nil means unconditionally put
this command in the variable `command-history'. Otherwise, that
is done only if an arg is read using the minibuffer.
The argument KEYS specifies the value to use instead of the
return value of the `this-command-keys' function when reading the
arguments; if it is nil, `this-command-keys' is used.
The argument SPECIAL, if non-nil, means that this command is
executing a special event, so ignore the prefix argument and
don't clear it."
(setq debug-on-next-call nil)
(let ((prefixarg (unless special
;; FIXME: This should probably be done around