File: esh-io.el.html

At the moment, only output redirection is supported in Eshell. To use input redirection, the following syntax will work, assuming that the command after the pipe is always an external command:

  cat <file> | <command>

Otherwise, output redirection and piping are provided in a manner consistent with most shells. Therefore, only unique features are mentioned here.

;_* Redirect to a Buffer or Process

Buffers and processes can be named with '#<buffer buffer-name>' and
'#<process process-name>', respectively. As a shorthand,
'#<buffer-name>' without the explicit "buffer" arg is equivalent to
'#<buffer buffer-name>'.

  echo hello > #<buffer *scratch*> # Overwrite '*scratch*' with 'hello'.
  echo hello > #<*scratch*> # Same as the command above.

  echo hello > #<process shell> # Pipe "hello" into the shell process.

;_* Insertion

To insert at the location of point in a buffer, use '>>>':

  echo alpha >>> #<buffer *scratch*>;

;_* Pseudo-devices

A few pseudo-devices are provided, since Emacs cannot write directly to a UNIX device file:

  echo alpha > /dev/null ; the bit bucket
  echo alpha > /dev/kill ; set the kill ring
  echo alpha >> /dev/clip ; append to the clipboard

;_* Multiple output targets

Eshell can write to multiple output targets, including pipes. Example:

  (+ 1 2) > a > b > c ; prints number to all three files (+ 1 2) > a | wc ; prints to 'a', and pipes to 'wc'

Defined variables (9)

Defined functions (22)

Defined faces (0)