diff options
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 |