# HG changeset patch # User Richard M. Stallman # Date 990379518 0 # Node ID d8b197c6f26d53a49c202b6f9ca83ad54a5dd3f7 # Parent ece336c2aab98b6f0743a8e81db663b4d8dea49f 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. diff -r ece336c2aab9 -r d8b197c6f26d man/misc.texi --- a/man/misc.texi Sun May 20 17:22:25 2001 +0000 +++ b/man/misc.texi Sun May 20 17:25:18 2001 +0000 @@ -311,7 +311,7 @@ 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 @@ @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 @@ @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 @@ @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 @@ @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 @@ 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 @@ @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 @@ 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 @@ 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 @@ 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 @@ @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 @@ @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 @@ @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 @@ @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}