From: John Wiegley <johnw@newartisans.com>
Date: Mon, 9 Apr 2001 23:42:19 +0000 (+0000)
Subject: A few additions.
X-Git-Tag: emacs-pretest-21.0.103~260
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=248ac71c7f57b75a5413f3a6d07d2cd2fc753193;p=emacs.git

A few additions.
---

diff --git a/man/eshell.texi b/man/eshell.texi
index af56d765c09..a760ac35ee2 100644
--- a/man/eshell.texi
+++ b/man/eshell.texi
@@ -1,6 +1,6 @@
 \input texinfo  @c -*-texinfo-*-
 
-@c "@(#)$Name:  $:$Id: eshell.texi,v 1.9 2001/01/28 18:48:45 eliz Exp $"
+@c "@(#)$Name:  $:$Id: eshell.texi,v 1.10 2001/03/04 07:07:00 rms Exp $"
 
 @c Documentation for Eshell: The Emacs Shell.
 @c Copyright (C) 1999, 2000  Free Software Foundation, Inc.
@@ -529,9 +529,29 @@ on your mind.  Have fun!
 * Scripts::                     
 @end menu
 
+Essentially, a command shell is all about invoking commands---and
+everything that entails.  So understanding how Eshell invokes commands
+is the key to comprehending how it all works.
+
 @node Invocation, Completion, Commands, Commands
 @section Invocation
 
+Unlike regular system shells, Eshell never invokes kernel functions
+directly, such as @code{exec(3)}.  Instead, it uses the Lisp functions
+available in the Emacs Lisp library.  It does this by transforming the
+command you specify into a callable Lisp form.@footnote{To see the Lisp
+form that will be invoked, type: @samp{eshell-parse-command "echo
+hello"}}
+
+This transformation, from the string of text typed at the command
+prompt, to the ultimate invocation of either a Lisp function or external
+command, follows these steps:
+
+@enumerate
+@item Parse the command string into separate arguments.
+@item 
+@end enumerate
+
 @node Completion, Aliases, Invocation, Commands
 @section Completion