mirror of
git://git.sv.gnu.org/emacs.git
synced 2025-12-26 07:11:34 -08:00
Explain M-! output can go in echo area.
Default for shell-completion-fignore is nil. C-c C-a is actually comint-bol-or-process-mark. shell-set-directory-error-hook does not really exist. comint-dynamic-complete-variable does not really exist. Terminal buffer is *terminal*, not *term*. Other minor changes.
This commit is contained in:
parent
6442995370
commit
fc98b4ba79
1 changed files with 37 additions and 37 deletions
|
|
@ -311,7 +311,7 @@ to an Emacs buffer named @samp{*shell*} or run a shell inside a terminal
|
|||
emulator window.
|
||||
|
||||
There is a shell implemented entirely in Emacs, documented in a separate
|
||||
manual. @xref{, ,Eshell , eshell, Eshell: The Emacs Shell}.
|
||||
manual. @xref{Top,Eshell,Eshell, eshell, Eshell: The Emacs Shell}.
|
||||
|
||||
@table @kbd
|
||||
@item M-! @var{cmd} @key{RET}
|
||||
|
|
@ -354,12 +354,13 @@ Start the Emacs shell.
|
|||
@kbd{M-!} (@code{shell-command}) reads a line of text using the
|
||||
minibuffer and executes it as a shell command in a subshell made just
|
||||
for that command. Standard input for the command comes from the null
|
||||
device. If the shell command produces any output, the output goes into
|
||||
an Emacs buffer named @samp{*Shell Command Output*}, which is displayed
|
||||
in another window but not selected. A numeric argument, as in @kbd{M-1
|
||||
M-!}, directs this command to insert any output into the current buffer.
|
||||
In that case, point is left before the output and the mark is set after
|
||||
the output.
|
||||
device. If the shell command produces any output, the output appears
|
||||
either in the echo area (if it is short), or in an Emacs buffer named
|
||||
@samp{*Shell Command Output*}, which is displayed in another window
|
||||
but not selected (if the output is long). A numeric argument, as in
|
||||
@kbd{M-1 M-!}, directs this command to insert any output into the
|
||||
current buffer instead. In that case, point is left before the output
|
||||
and the mark is set after the output.
|
||||
|
||||
If the shell command line ends in @samp{&}, it runs asynchronously.
|
||||
For a synchronous shell command, @code{shell-command} returns the
|
||||
|
|
@ -477,9 +478,9 @@ of the special key bindings of Shell mode:
|
|||
@findex comint-send-input
|
||||
At end of buffer send line as input; otherwise, copy current line to
|
||||
end of buffer and send it (@code{comint-send-input}). When a line is
|
||||
copied, any prompt at the beginning if the line (text output by
|
||||
programs preceding your input) is omitted. See also
|
||||
@code{comint-use-prompt-regexp-instead-of-fields}).
|
||||
copied, any prompt at the beginning of the line (text output by
|
||||
programs preceding your input) is omitted. (See also the variable
|
||||
@code{comint-use-prompt-regexp-instead-of-fields}.)
|
||||
|
||||
@item @key{TAB}
|
||||
@kindex TAB @r{(Shell mode)}
|
||||
|
|
@ -491,8 +492,9 @@ references (@pxref{History References}) and environment variable names.
|
|||
@vindex shell-completion-fignore
|
||||
@vindex comint-completion-fignore
|
||||
The variable @code{shell-completion-fignore} specifies a list of file
|
||||
name extensions to ignore in Shell mode completion. The default setting
|
||||
ignores file names ending in @samp{~}, @samp{#} or @samp{%}. Other
|
||||
name extensions to ignore in Shell mode completion. The default
|
||||
setting is @code{nil}, but some users prefer @code{("~" "#" "%")} to
|
||||
ignore file names ending in @samp{~}, @samp{#} or @samp{%}. Other
|
||||
related Comint modes use the variable @code{comint-completion-fignore}
|
||||
instead.
|
||||
|
||||
|
|
@ -513,13 +515,14 @@ position in the buffer, @kbd{C-d} deletes a character as usual.
|
|||
|
||||
@item C-c C-a
|
||||
@kindex C-c C-a @r{(Shell mode)}
|
||||
@findex comint-bol
|
||||
@findex comint-bol-or-process-mark
|
||||
Move to the beginning of the line, but after the prompt if any
|
||||
(@code{comint-bol}). If you repeat this command twice in a row, the
|
||||
second time it moves back to the process mark, which is the beginning of
|
||||
the input that you have not yet sent to the subshell. (Normally that is
|
||||
the same place---the end of the prompt on this line---but after @kbd{C-c
|
||||
@key{SPC}} the process mark may be in a previous line.)
|
||||
(@code{comint-bol-or-process-mark}). If you repeat this command twice
|
||||
in a row, the second time it moves back to the process mark, which is
|
||||
the beginning of the input that you have not yet sent to the subshell.
|
||||
(Normally that is the same place---the end of the prompt on this
|
||||
line---but after @kbd{C-c @key{SPC}} the process mark may be in a
|
||||
previous line.)
|
||||
|
||||
@item C-c @key{SPC}
|
||||
Accumulate multiple lines of input, then send them together. This
|
||||
|
|
@ -859,10 +862,12 @@ recognize commands with the meaning of @samp{popd} and @samp{cd}.
|
|||
These commands are recognized only at the beginning of a shell command
|
||||
line.
|
||||
|
||||
@ignore @c This seems to have been deleted long ago.
|
||||
@vindex shell-set-directory-error-hook
|
||||
If Emacs gets an error while trying to handle what it believes is a
|
||||
@samp{cd}, @samp{pushd} or @samp{popd} command, it runs the hook
|
||||
@code{shell-set-directory-error-hook} (@pxref{Hooks}).
|
||||
@end ignore
|
||||
|
||||
@findex dirs
|
||||
If Emacs gets confused about changes in the current directory of the
|
||||
|
|
@ -920,16 +925,9 @@ algorithm cannot add even a single character.
|
|||
@code{comint-completion-autolist}, if non-@code{nil}, says to list all
|
||||
the possible completions whenever completion is not exact.
|
||||
|
||||
@findex comint-dynamic-complete-variable
|
||||
The command @code{comint-dynamic-complete-variable} does variable-name
|
||||
completion using the environment variables as set within Emacs. The
|
||||
variables controlling file name completion apply to variable-name
|
||||
completion too. This command is normally available through the menu
|
||||
bar.
|
||||
|
||||
@vindex shell-command-execonly
|
||||
@vindex shell-completion-execonly
|
||||
Command completion normally considers only executable files.
|
||||
If you set @code{shell-command-execonly} to @code{nil},
|
||||
If you set @code{shell-completion-execonly} to @code{nil},
|
||||
it considers nonexecutable files as well.
|
||||
|
||||
@findex shell-pushd-tohome
|
||||
|
|
@ -949,8 +947,8 @@ underlying shell, of course.
|
|||
|
||||
To run a subshell in a terminal emulator, putting its typescript in
|
||||
an Emacs buffer, use @kbd{M-x term}. This creates (or reuses) a
|
||||
buffer named @samp{*term*}, and runs a subshell with input coming from
|
||||
your keyboard, and output going to that buffer.
|
||||
buffer named @samp{*terminal*}, and runs a subshell with input coming
|
||||
from your keyboard, and output going to that buffer.
|
||||
|
||||
The terminal emulator uses Term mode, which has two input modes. In
|
||||
line mode, Term basically acts like Shell mode; see @ref{Shell Mode}.
|
||||
|
|
@ -974,7 +972,7 @@ You can actually run Emacs inside an Emacs Term window.
|
|||
|
||||
The file name used to load the subshell is determined the same way
|
||||
as for Shell mode. To make multiple terminal emulators, rename the
|
||||
buffer @samp{*term*} to something different using @kbd{M-x
|
||||
buffer @samp{*terminal*} to something different using @kbd{M-x
|
||||
rename-uniquely}, just as with Shell mode.
|
||||
|
||||
Unlike Shell mode, Term mode does not track the current directory by
|
||||
|
|
@ -1169,8 +1167,8 @@ use @env{EDITOR} wait for the ``editor'' (actually, @code{emacsclient})
|
|||
to exit. @kbd{C-x #} also checks for other pending external requests
|
||||
to edit various files, and selects the next such file.
|
||||
|
||||
You can switch to a server buffer manually if you wish; you don't have
|
||||
to arrive at it with @kbd{C-x #}. But @kbd{C-x #} is the only way to
|
||||
You can switch to a server buffer manually if you wish; you don't
|
||||
have to arrive at it with @kbd{C-x #}. But @kbd{C-x #} is the way to
|
||||
say that you are ``finished'' with one.
|
||||
|
||||
@vindex server-kill-new-buffers
|
||||
|
|
@ -1373,7 +1371,8 @@ it to the printer.
|
|||
@cindex handwriting
|
||||
@kbd{M-x handwrite} is more frivolous. It generates a PostScript
|
||||
rendition of the current buffer as a cursive handwritten document. It
|
||||
can be customized in group @code{handwrite}.
|
||||
can be customized in group @code{handwrite}. This function only
|
||||
supports ISO 8859-1 characters.
|
||||
|
||||
@ifinfo
|
||||
The following section describes variables for customizing these commands.
|
||||
|
|
@ -1814,8 +1813,9 @@ invoked @code{hexl-mode}.
|
|||
@end table
|
||||
|
||||
@noindent
|
||||
Other Hexl commands let you insert strings (sequences) of binary bytes,
|
||||
move by short's or int's, etc.; type @kbd{C-h a hexl- RET} for details.
|
||||
Other Hexl commands let you insert strings (sequences) of binary
|
||||
bytes, move by short's or int's, etc.; type @kbd{C-h a hexl-
|
||||
@key{RET}} for details.
|
||||
|
||||
|
||||
@node Saving Emacs Sessions, Recursive Edit, Editing Binary Files, Top
|
||||
|
|
@ -2107,7 +2107,7 @@ fashion.
|
|||
@cindex URLs
|
||||
|
||||
@table @kbd
|
||||
@item M-x browse-url @key{RET} @var{url} @key{ret}
|
||||
@item M-x browse-url @key{RET} @var{url} @key{RET}
|
||||
Load a URL into a Web browser.
|
||||
@end table
|
||||
|
||||
|
|
@ -2220,7 +2220,7 @@ find the one you select (@code{ffap-menu}).
|
|||
|
||||
@table @kbd
|
||||
@item M-x find-function @key{RET} @var{function} @key{RET}
|
||||
Find the definition @var{function} in its source file.
|
||||
Find the definition of @var{function} in its source file.
|
||||
@item M-x find-variable @key{RET} @var{variable} @key{RET}
|
||||
Find the definition of @var{variable} in its source file.
|
||||
@item M-x find-function-on-key @key{RET} @var{key}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue