aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorJohn Wiegley2017-09-05 14:24:25 +0100
committerJohn Wiegley2017-09-05 14:24:25 +0100
commitc09116e64012534ee244c22f1ba4f2e106f6ed91 (patch)
tree592e4ed790b546ae368e2da0f930005cc587566a
parent979797b9eca0ab009cc75a29765f998ec2aa1b45 (diff)
downloademacs-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.texi18
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.
142looks like: But don't let it fool you; once you know what's going on, 142looks like: But don't let it fool you; once you know what's going on,
143it's easier than it looks: @code{ls -lt **/*.doc(Lk+50aM+5)}.} 143it'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
150Eshell is @emph{not} a replacement for system shells such as
151@command{bash} or @command{zsh}. Use Eshell when you want to move
152text between Emacs and external processes; if you only want to pipe
153output from one external process to another (and then another, and so
154on), use a system shell, because Emacs's IO system is buffer oriented,
155not stream oriented, and is very inefficient at such tasks. If you
156want to write shell scripts in Eshell, don't; either write an elisp
157library or use a system shell.
158
159Some things Eshell just doesn't do well. It fills the niche between
160IELM and your system shell, where the peculiar use-cases lie, and it
161is 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