[Emacs-diffs] /srv/bzr/emacs/trunk r111824: Documented Eshell's insert output-redirection operator

[Aidan Gauland]

------------------------------------------------------------
revno: 111824
committer: Aidan Gauland <address@hidden>
branch nick: trunk
timestamp: Tue 2013-02-19 07:27:51 +1300
message:
  Documented Eshell's insert output-redirection operator
modified:
  ChangeLog
  doc/misc/eshell.texi

=== modified file 'ChangeLog'
--- a/ChangeLog 2013-02-15 06:35:54 +0000
+++ b/ChangeLog 2013-02-18 18:27:51 +0000
@@ -1,3 +1,8 @@
+2013-02-18  Aidan Gauland  <address@hidden>
+
+       * doc/misc/eshell.texi: Added documentation for Eshell insert
+       output redirection operator, >>>.
+
 2013-02-15  Paul Eggert  <address@hidden>
 
        Fix AIX port (Bug#13650).

=== modified file 'doc/misc/eshell.texi'
--- a/doc/misc/eshell.texi      2013-02-13 04:31:09 +0000
+++ b/doc/misc/eshell.texi      2013-02-18 18:27:51 +0000
@@ -709,11 +709,17 @@
 @var{eshell-visual-commands}.
 
 Redirection is mostly the same in Eshell as it is in other command
-shells.  The output redirection operators @code{>} and @code{>>} as well
-as pipes are supported, but there is not yet any support for input
-redirection.  Output can also be redirected to Elisp functions, using
+shells.  The output redirection operators @code{>} and @code{>>} as
+well as pipes are supported, but there is not yet any support for
+input redirection.  Output can also be redirected to buffers, using
+the @code{>>>} redirection operator, and Elisp functions, using
 virtual devices.
 
+The buffer redirection operator, @code{>>>}, expects a buffer object
+on the right-hand side, into which it inserts the output of the
+left-hand side.  e.g., @samp{echo hello >>> #<buffer *scratch*>}
+inserts the string @code{"hello"} into the @code{*scratch*} buffer.
+
 @var{eshell-virtual-targets} is a list of mappings of virtual device
 names to functions.  Eshell comes with two virtual devices:
 @file{/dev/kill}, which sends the text to the kill ring, and
@@ -725,8 +731,9 @@
 @code{function} may be either a lambda or a function name.  If
 @code{mode} is nil, then the function is the output function; if it is
 non-nil, then the function is passed the redirection mode as a
address@hidden, @code{append}, or @code{insert}--and the
-function is expected to return the output function.
address@hidden for @code{>}, @code{append} for @code{>>}, or
address@hidden for @code{>>>}--and the function is expected to return
+the output function.
 
 The output function is called once on each line of output until
 @code{nil} is passed, indicating end of output.