"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "doc/emacs/m-x.texi" between
emacs-25.3.tar.xz and emacs-26.1.tar.xz

About: GNU Emacs - the extensible, customizable, self-documenting real-time display editor.

m-x.texi  (emacs-25.3.tar.xz):m-x.texi  (emacs-26.1.tar.xz)
@c This is part of the Emacs manual. @c This is part of the Emacs manual.
@c Copyright (C) 1985-1987, 1993-1995, 1997, 2001-2017 Free Software @c Copyright (C) 1985-1987, 1993-1995, 1997, 2001-2018 Free Software
@c Foundation, Inc. @c Foundation, Inc.
@c See file emacs.texi for copying conditions. @c See file emacs.texi for copying conditions.
@node M-x @node M-x
@chapter Running Commands by Name @chapter Running Commands by Name
Every Emacs command has a name that you can use to run it. For Every Emacs command has a name that you can use to run it. For
convenience, many commands also have key bindings. You can run those convenience, many commands also have key bindings. You can run those
commands by typing the keys, or run them by name. Most Emacs commands commands by typing the keys, or run them by name. Most Emacs commands
have no key bindings, so the only way to run them is by name. have no key bindings, so the only way to run them is by name.
(@xref{Key Bindings}, for how to set up key bindings.) (@xref{Key Bindings}, for how to set up key bindings.)
skipping to change at line 59 skipping to change at line 59
full name. Obsolete commands are those for which newer, better full name. Obsolete commands are those for which newer, better
alternatives exist, and which are slated for removal in some future alternatives exist, and which are slated for removal in some future
Emacs release. Emacs release.
To cancel the @kbd{M-x} and not run a command, type @kbd{C-g} instead 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. of entering the command name. This takes you back to command level.
To pass a numeric argument to the command you are invoking with To pass a numeric argument to the command you are invoking with
@kbd{M-x}, specify the numeric argument before @kbd{M-x}. The @kbd{M-x}, specify the numeric argument before @kbd{M-x}. The
argument value appears in the prompt while the command name is being argument value appears in the prompt while the command name is being
read, and finally @kbd{M-x} passes the argument to that command. read, and finally @kbd{M-x} passes the argument to that command. For
example, to pass the numeric argument of 42 to the command
@code{forward-char} you can type @kbd{C-u 42 M-x forward-char
@key{RET}}.
@vindex suggest-key-bindings @vindex suggest-key-bindings
When the command you run with @kbd{M-x} has a key binding, Emacs When the command you run with @kbd{M-x} has a key binding, Emacs
mentions this in the echo area after running the command. For 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 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 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 messages by setting the variable @code{suggest-key-bindings} to
@code{nil}. The value of @code{suggest-key-bindings} can also be a @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 number, in which case Emacs will show the binding for that many
seconds before removing it from display. The default behavior is to seconds before removing it from display. The default behavior is to
display the binding for 2 seconds. display the binding for 2 seconds.
@vindex extended-command-suggest-shorter
Commands that don't have key bindings, can still be invoked after 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 typing less than their full name at the @samp{M-x} prompt. Emacs
mentions such shorthands in the echo area if they are significantly mentions such shorthands in the echo area if they are significantly
shorter than the full command name. The setting of shorter than the full command name, and
@code{suggest-key-bindings} affects these hints as well. @code{extended-command-suggest-shorter} is non-@code{nil}. 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 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 omit the @key{RET} that terminates the name. Thus we might say
@kbd{M-x auto-fill-mode} rather than @kbd{M-x auto-fill-mode @kbd{M-x auto-fill-mode} rather than @w{@kbd{M-x auto-fill-mode
@key{RET}}. We mention the @key{RET} only for emphasis, such as when @key{RET}}}. We mention the @key{RET} only for emphasis, such as when
the command is followed by arguments. the command is followed by arguments.
@findex execute-extended-command @findex execute-extended-command
@kbd{M-x} works by running the command @kbd{M-x} works by running the command
@code{execute-extended-command}, which is responsible for reading the @code{execute-extended-command}, which is responsible for reading the
name of another command and invoking it. name of another command and invoking it.
 End of changes. 5 change blocks. 
6 lines changed or deleted 11 lines changed or added

Home  |  About  |  Features  |  All  |  Newest  |  Dox  |  Diffs  |  RSS Feeds  |  Screenshots  |  Comments  |  Imprint  |  Privacy  |  HTTP(S)