Document new features if Eshell

* doc/misc/eshell.texi (Input/Output): Document the new
'#<bufname>' syntax.
(Input/Output): Document 'eshell-destroy-buffer-when-process-dies'.
Disable "Key Index" generation, as there are no @kindex entries in
this manual.
This commit is contained in:
Eli Zaretskii 2016-01-10 19:24:54 +02:00
parent 9c4e4e0cc9
commit e667bbb628
2 changed files with 17 additions and 0 deletions

View file

@ -84,7 +84,9 @@ such as @command{bash}, @command{zsh}, @command{rc}, or
* Concept Index:: * Concept Index::
* Function and Variable Index:: * Function and Variable Index::
* Command Index:: * Command Index::
@ignore
* Key Index:: * Key Index::
@end ignore
@end menu @end menu
@node Introduction @node Introduction
@ -670,6 +672,12 @@ page long. If that occurs to you, search for configuration options
for calling @samp{less} without the @samp{-F} option. For Git, you for calling @samp{less} without the @samp{-F} option. For Git, you
can do that using @samp{git config --global core.pager 'less -+F'}. can do that using @samp{git config --global core.pager 'less -+F'}.
@vindex eshell-destroy-buffer-when-process-dies
If you want the buffers created by visual programs killed when the
program exits, customize the variable
@code{eshell-destroy-buffer-when-process-dies} to a non-@code{nil}
value; the default is @code{nil}.
@section Redirection @section Redirection
Redirection is mostly the same in Eshell as it is in other command Redirection is mostly the same in Eshell as it is in other command
shells. The output redirection operators @code{>} and @code{>>} as shells. The output redirection operators @code{>} and @code{>>} as
@ -682,6 +690,8 @@ The buffer redirection operator, @code{>>>}, expects a buffer object
on the right-hand side, into which it inserts the output of the on the right-hand side, into which it inserts the output of the
left-hand side. e.g., @samp{echo hello >>> #<buffer *scratch*>} left-hand side. e.g., @samp{echo hello >>> #<buffer *scratch*>}
inserts the string @code{"hello"} into the @file{*scratch*} buffer. inserts the string @code{"hello"} into the @file{*scratch*} buffer.
The convenience shorthand variant @samp{#<@var{buffer-name}>}, as in
@samp{#<*scratch*>}, is also accepted.
@code{eshell-virtual-targets} is a list of mappings of virtual device @code{eshell-virtual-targets} is a list of mappings of virtual device
names to functions. Eshell comes with two virtual devices: names to functions. Eshell comes with two virtual devices:
@ -1241,8 +1251,13 @@ Since it keeps the cursor up where the command was invoked.
@printindex cm @printindex cm
@c There are no @kindex entries in this manual; avoid generating an
@c empty menu.
@ignore
@node Key Index @node Key Index
@unnumbered Key Index @unnumbered Key Index
@printindex ky @printindex ky
@end ignore
@bye @bye

View file

@ -1044,12 +1044,14 @@ EUDC's PH backend (eudcb-ph.el) is obsolete.
*** The new built-in command `clear' can scroll window contents out of sight. *** The new built-in command `clear' can scroll window contents out of sight.
If provided with an optional non-nil argument, the scrollback contents will be cleared. If provided with an optional non-nil argument, the scrollback contents will be cleared.
+++
*** New buffer syntax '#<buffer-name>', which is equivalent to *** New buffer syntax '#<buffer-name>', which is equivalent to
'#<buffer buffer-name>'. This shorthand makes interacting with '#<buffer buffer-name>'. This shorthand makes interacting with
buffers from eshell more convenient. Custom variable buffers from eshell more convenient. Custom variable
`eshell-buffer-shorthand', which has been broken for a while, has been `eshell-buffer-shorthand', which has been broken for a while, has been
removed. removed.
+++
*** By default, eshell "visual" program buffers (created by *** By default, eshell "visual" program buffers (created by
`eshell-visual-commands' and similar custom vars) are no longer killed `eshell-visual-commands' and similar custom vars) are no longer killed
when their processes die. This fixes issues with short-lived commands when their processes die. This fixes issues with short-lived commands