aboutsummaryrefslogtreecommitdiffstats
path: root/doc/misc/eshell.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/misc/eshell.texi')
-rw-r--r--doc/misc/eshell.texi24
1 files changed, 12 insertions, 12 deletions
diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi
index 4604b262e72..bbe741a7a1d 100644
--- a/doc/misc/eshell.texi
+++ b/doc/misc/eshell.texi
@@ -353,7 +353,7 @@ sudo is an alias, defined as "*sudo $*"
353 353
354@vindex eshell-prefer-lisp-functions 354@vindex eshell-prefer-lisp-functions
355If you would prefer to use the built-in commands instead of the external 355If you would prefer to use the built-in commands instead of the external
356commands, set @var{eshell-prefer-lisp-functions} to @code{t}. 356commands, set @code{eshell-prefer-lisp-functions} to @code{t}.
357 357
358Some of the built-in commands have different behaviour from their 358Some of the built-in commands have different behaviour from their
359external counterparts, and some have no external counterpart. Most of 359external counterparts, and some have no external counterpart. Most of
@@ -515,7 +515,7 @@ Aliases are commands that expand to a longer input line. For example,
515with the command invocation @samp{alias ll ls -l}; with this defined, 515with the command invocation @samp{alias ll ls -l}; with this defined,
516running @samp{ll foo} in Eshell will actually run @samp{ls -l foo}. 516running @samp{ll foo} in Eshell will actually run @samp{ls -l foo}.
517Aliases defined (or deleted) by the @command{alias} command are 517Aliases defined (or deleted) by the @command{alias} command are
518automatically written to the file named by @var{eshell-aliases-file}, 518automatically written to the file named by @code{eshell-aliases-file},
519which you can also edit directly (although you will have to manually 519which you can also edit directly (although you will have to manually
520reload it). 520reload it).
521 521
@@ -539,7 +539,7 @@ by @code{!foo:n}.
539 539
540The history ring is loaded from a file at the start of every session, 540The history ring is loaded from a file at the start of every session,
541and written back to the file at the end of every session. The file path 541and written back to the file at the end of every session. The file path
542is specified in @var{eshell-history-file-name}. Unlike other shells, 542is specified in @code{eshell-history-file-name}. Unlike other shells,
543such as Bash, Eshell can not be configured to keep a history ring of a 543such as Bash, Eshell can not be configured to keep a history ring of a
544different size than that of the history file. 544different size than that of the history file.
545 545
@@ -721,11 +721,11 @@ terminal emulator.
721Programs that need a terminal to display output properly are referred 721Programs that need a terminal to display output properly are referred
722to in this manual as ``visual commands,'' because they are not simply 722to in this manual as ``visual commands,'' because they are not simply
723line-oriented. You must tell Eshell which commands are visual, by 723line-oriented. You must tell Eshell which commands are visual, by
724adding them to @var{eshell-visual-commands}; for commands that are 724adding them to @code{eshell-visual-commands}; for commands that are
725visual for only certain @emph{sub}-commands -- e.g. @samp{git log} but 725visual for only certain @emph{sub}-commands -- e.g. @samp{git log} but
726not @samp{git status} -- use @var{eshell-visual-subcommands}; and for 726not @samp{git status} -- use @code{eshell-visual-subcommands}; and for
727commands that are visual only when passed certain options, use 727commands that are visual only when passed certain options, use
728@var{eshell-visual-options}. 728@code{eshell-visual-options}.
729 729
730@section Redirection 730@section Redirection
731Redirection is mostly the same in Eshell as it is in other command 731Redirection is mostly the same in Eshell as it is in other command
@@ -740,16 +740,16 @@ on the right-hand side, into which it inserts the output of the
740left-hand side. e.g., @samp{echo hello >>> #<buffer *scratch*>} 740left-hand side. e.g., @samp{echo hello >>> #<buffer *scratch*>}
741inserts the string @code{"hello"} into the @code{*scratch*} buffer. 741inserts the string @code{"hello"} into the @code{*scratch*} buffer.
742 742
743@var{eshell-virtual-targets} is a list of mappings of virtual device 743@code{eshell-virtual-targets} is a list of mappings of virtual device
744names to functions. Eshell comes with two virtual devices: 744names to functions. Eshell comes with two virtual devices:
745@file{/dev/kill}, which sends the text to the kill ring, and 745@file{/dev/kill}, which sends the text to the kill ring, and
746@file{/dev/clip}, which sends text to the clipboard. 746@file{/dev/clip}, which sends text to the clipboard.
747 747
748You can, of course, define your own virtual targets. They are defined 748You can, of course, define your own virtual targets. They are defined
749by adding a list of the form @code{("/dev/name" function mode)} to 749by adding a list of the form @samp{("/dev/name" @var{function} @var{mode})} to
750@var{eshell-virtual-targets}. The first element is the device name; 750@code{eshell-virtual-targets}. The first element is the device name;
751@code{function} may be either a lambda or a function name. If 751@var{function} may be either a lambda or a function name. If
752@code{mode} is nil, then the function is the output function; if it is 752@var{mode} is nil, then the function is the output function; if it is
753non-nil, then the function is passed the redirection mode as a 753non-nil, then the function is passed the redirection mode as a
754symbol--@code{overwrite} for @code{>}, @code{append} for @code{>>}, or 754symbol--@code{overwrite} for @code{>}, @code{append} for @code{>>}, or
755@code{insert} for @code{>>>}--and the function is expected to return 755@code{insert} for @code{>>>}--and the function is expected to return
@@ -774,7 +774,7 @@ Eshell module.} You also need to load the following as shown:
774 774
775@example 775@example
776(eval-when-compile 776(eval-when-compile
777 (require 'cl) 777 (require 'cl-lib)
778 (require 'esh-mode) 778 (require 'esh-mode)
779 (require 'eshell)) 779 (require 'eshell))
780 780