diff options
author | Eli Zaretskii <eliz@gnu.org> | 2015-11-28 20:27:52 +0200 |
---|---|---|
committer | Eli Zaretskii <eliz@gnu.org> | 2015-11-28 20:27:52 +0200 |
commit | 63f7e4b4b95f8c347144596efcb9b5d806724c8d (patch) | |
tree | 0b5fa2ad9d3bdfcd2fc7a120964b8ca432e2d68d /doc/emacs/m-x.texi | |
parent | fadc3e0dfd7fafa9c65f689a59244fdb3ca94e54 (diff) | |
download | emacs-63f7e4b4b95f8c347144596efcb9b5d806724c8d.tar.gz |
Document the shorthand hints displayed by M-x
* doc/emacs/m-x.texi (M-x): Document the numeric meaning of
suggest-key-bindings. Document the shorthand hints for commands
that have no key bindings. Document that M-x completion ignores
obsolete commands.
* etc/NEWS: Move the M-x entry to "Editing Changes" and mark it as
documented.
Diffstat (limited to 'doc/emacs/m-x.texi')
-rw-r--r-- | doc/emacs/m-x.texi | 18 |
1 files changed, 17 insertions, 1 deletions
diff --git a/doc/emacs/m-x.texi b/doc/emacs/m-x.texi index c9ae559f984..795d6fe373b 100644 --- a/doc/emacs/m-x.texi +++ b/doc/emacs/m-x.texi @@ -43,6 +43,13 @@ Note that @code{forward-char} is the same command that you invoke with the key @kbd{C-f}. The existence of a key binding does not stop you from running the command by name. +@cindex obsolete command + When @kbd{M-x} completes on commands, it ignores the commands that +are declared @dfn{obsolete}; for these, you will have to type their +full name. Obsolete commands are those for which newer, better +alternatives exist, and which are slated for removal in some future +Emacs release. + To cancel the @kbd{M-x} and not run a command, type @kbd{C-g} instead of entering the command name. This takes you back to command level. @@ -57,7 +64,16 @@ mentions this in the echo area after running the command. For example, if you type @kbd{M-x forward-word}, the message says that you can run the same command by typing @kbd{M-f}. You can turn off these messages by setting the variable @code{suggest-key-bindings} to -@code{nil}. +@code{nil}. The value of @code{suggest-key-bindings} can also be a +number, in which case Emacs will show the binding for that many +seconds before removing it from display. The default behavior is to +display the binding for 2 seconds. + + Commands that don't have key bindings, can still be invoked after +typing less than their full name at the @samp{M-x} prompt. Emacs +mentions such shorthands in the echo area if they are significantly +shorter than the full command name. The setting of +@code{suggest-key-bindings} affects these hints as well. In this manual, when we speak of running a command by name, we often omit the @key{RET} that terminates the name. Thus we might say |