diff options
| author | John Wiegley | 2017-09-05 14:24:25 +0100 |
|---|---|---|
| committer | John Wiegley | 2017-09-05 14:24:25 +0100 |
| commit | c09116e64012534ee244c22f1ba4f2e106f6ed91 (patch) | |
| tree | 592e4ed790b546ae368e2da0f930005cc587566a | |
| parent | 979797b9eca0ab009cc75a29765f998ec2aa1b45 (diff) | |
| download | emacs-c09116e64012534ee244c22f1ba4f2e106f6ed91.tar.gz emacs-c09116e64012534ee244c22f1ba4f2e106f6ed91.zip | |
Remove an opinionated section on "What Eshell is not"
I don't find this information to accurately reflect possible use cases
for Eshell; plus, it doesn't offer much in the way of information,
just opinion.
| -rw-r--r-- | doc/misc/eshell.texi | 18 |
1 files changed, 0 insertions, 18 deletions
diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi index a7651b21d61..8963826c4cc 100644 --- a/doc/misc/eshell.texi +++ b/doc/misc/eshell.texi | |||
| @@ -142,24 +142,6 @@ Any tool you use often deserves the time spent learning to master it. | |||
| 142 | looks like: But don't let it fool you; once you know what's going on, | 142 | looks like: But don't let it fool you; once you know what's going on, |
| 143 | it's easier than it looks: @code{ls -lt **/*.doc(Lk+50aM+5)}.} | 143 | it's easier than it looks: @code{ls -lt **/*.doc(Lk+50aM+5)}.} |
| 144 | 144 | ||
| 145 | @section What Eshell is not | ||
| 146 | @cindex Eshell, what it is not | ||
| 147 | @cindex what Eshell is not | ||
| 148 | @cindex what isn't Eshell? | ||
| 149 | |||
| 150 | Eshell is @emph{not} a replacement for system shells such as | ||
| 151 | @command{bash} or @command{zsh}. Use Eshell when you want to move | ||
| 152 | text between Emacs and external processes; if you only want to pipe | ||
| 153 | output from one external process to another (and then another, and so | ||
| 154 | on), use a system shell, because Emacs's IO system is buffer oriented, | ||
| 155 | not stream oriented, and is very inefficient at such tasks. If you | ||
| 156 | want to write shell scripts in Eshell, don't; either write an elisp | ||
| 157 | library or use a system shell. | ||
| 158 | |||
| 159 | Some things Eshell just doesn't do well. It fills the niche between | ||
| 160 | IELM and your system shell, where the peculiar use-cases lie, and it | ||
| 161 | is less than ideal outside that niche. | ||
| 162 | |||
| 163 | @menu | 145 | @menu |
| 164 | * Contributors to Eshell:: People who have helped out! | 146 | * Contributors to Eshell:: People who have helped out! |
| 165 | @end menu | 147 | @end menu |