\input texinfo @c -*-texinfo-*-
-
-@c "@(#)$Name: $:$Id: eshell.texi,v 1.12 2001/04/19 15:10:31 gerd Exp $"
-
-@c Documentation for Eshell: The Emacs Shell.
-@c Copyright (C) 1999, 2000 Free Software Foundation, Inc.
-
-@c This file is part of GNU Emacs
-
-@c GNU Emacs is free software; you can redistribute it and/or modify it
-@c under the terms of the GNU General Public License as published by the
-@c Free Software Foundation; either version 2 of the License, or (at
-@c your option) any later version.
-
-@c GNU Emacs is distributed in the hope that it will be useful, but
-@c WITHOUT ANY WARRANTY; without even the implied warraonty of
-@c MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
-@c General Public License for more details.
-
-@c You should have received a copy of the GNU General Public License
-@c along with Eshell; see the file COPYING. If not, write to the Free
-@c Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
-
@c %**start of header
@setfilename ../info/eshell
@settitle Eshell: The Emacs Shell
+@synindex vr fn
@c %**end of header
-@dircategory Emacs
-@direntry
-* Eshell: (eshell). A command shell implemented in Emacs Lisp.
-@end direntry
-@setchapternewpage on
-
-@ifinfo
-Copyright @copyright{} 1999, 2000, 2001 Free Software Foundation, Inc.
+@copying
+This manual is for Eshell, the Emacs shell.
+
+Copyright @copyright{} 1999, 2000, 2001, 2002, 2004 Free Software Foundation, Inc.
+@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation; with no
Documentation License. If you want to distribute this document
separately from the collection, you can do so by adding a copy of the
license to the document, as described in section 6 of the license.
-@end ifinfo
+@end quotation
+@end copying
+
+@dircategory Emacs
+@direntry
+* Eshell: (eshell). A command shell implemented in Emacs Lisp.
+@end direntry
+
+@setchapternewpage on
-@synindex vr fn
-@c The titlepage section does not appear in the Info file.
@titlepage
@sp 4
@c The title is printed in a large font.
@center John Wiegley
@c -date-
-@c The following two commands start the copyright page for the printed
-@c manual. This will not appear in the Info file.
@page
@vskip 0pt plus 1filll
-Copyright @copyright{} 1999, 2000, 2001 Free Software Foundation, Inc.
-
-Permission is granted to copy, distribute and/or modify this document
-under the terms of the GNU Free Documentation License, Version 1.1 or
-any later version published by the Free Software Foundation; with no
-Invariant Sections, with the Front-Cover texts being ``A GNU
-Manual'', and with the Back-Cover Texts as in (a) below. A copy of the
-license is included in the section entitled ``GNU Free Documentation
-License'' in the Emacs manual.
-
-(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
-this GNU Manual, like GNU software. Copies published by the Free
-Software Foundation raise funds for GNU development.''
-
-This document is part of a collection distributed under the GNU Free
-Documentation License. If you want to distribute this document
-separately from the collection, you can do so by adding a copy of the
-license to the document, as described in section 6 of the license.
+@insertcopying
@end titlepage
@contents
@c The real text starts here
@c ================================================================
-@ifinfo
+@ifnottex
@node Top, What is Eshell?, (dir), (dir)
@top Eshell
@command{rc}, or @command{4dos}; since Emacs itself is capable of
handling the sort of tasks accomplished by those tools.
@c This manual is updated to release 2.4 of Eshell.
-@end ifinfo
+@end ifnottex
@menu
* What is Eshell?:: A brief introduction to the Emacs Shell.
* Installation:: For users of Emacs 20 and XEmacs.
-* Command basics:: The basics of command usage.
-* Commands::
-* Arguments::
-* Input/Output::
-* Process control::
-* Extension modules::
-* Extras and Goodies::
+* Command basics:: The basics of command usage.
+* Commands::
+* Arguments::
+* Input/Output::
+* Process control::
+* Extension modules::
+* Extras and Goodies::
* Bugs and ideas:: Known problems, and future ideas.
-* Concept Index::
-* Function and Variable Index::
-* Key Index::
+* Concept Index::
+* Function and Variable Index::
+* Key Index::
@end menu
@node What is Eshell?
As mentioned above, Eshell comes preinstalled as of Emacs 21. If you're
using Emacs 20.4 or later, or XEmacs 21, you can download the most
recent version of Eshell from
-@url{http://www.gci-net.com/users/j/johnw/Emacs/eshell.tar.gz}.
+@url{http://www.gci-net.com/users/j/johnw/Emacs/packages/eshell.tar.gz}.
However, if you are using Emacs 21, you may skip this section.
@chapter Commands
@menu
-* Invocation::
-* Completion::
-* Aliases::
-* History::
-* Scripts::
+* Invocation::
+* Completion::
+* Aliases::
+* History::
+* Scripts::
* Built-ins::
@end menu
@enumerate
@item Parse the command string into separate arguments.
-@item
+@item
@end enumerate
@node Completion
Giving the command @samp{cd -} changes back to the previous working
directory (this is the same as @samp{cd $-}).
-The command @samp{cd =} shows the directory stack.
+The command @samp{cd =} shows the directory stack. Each line is
+numbered.
With @samp{cd =foo}, Eshell searches the directory stack for a
directory matching the regular expression @samp{foo} and changes to
that directory.
+With @samp{cd -42}, you can access the directory stack by number.
+
@end table
@chapter Arguments
@menu
-* The Parser::
-* Variables::
-* Substitution::
-* Globbing::
-* Predicates::
+* The Parser::
+* Variables::
+* Substitution::
+* Globbing::
+* Predicates::
@end menu
@node The Parser
@chapter Extension modules
@menu
-* Writing a module::
-* Module testing::
-* Directory handling::
-* Key rebinding::
-* Smart scrolling::
-* Terminal emulation::
-* Built-in UNIX commands::
+* Writing a module::
+* Module testing::
+* Directory handling::
+* Key rebinding::
+* Smart scrolling::
+* Terminal emulation::
+* Built-in UNIX commands::
@end menu
@node Writing a module
find this package useful!
@menu
-* Known problems::
+* Known problems::
@end menu
@node Known problems
which is the version included with Emacs 21.1.
@table @asis
+@item Documentation incomplete
+
@item Differentiate between aliases and functions
Allow for a bash-compatible syntax, such as:
@item Using C-p and C-n with rebind gets into a locked state
-This happened a few times in Emacs 21, but has been unreproducable
+This happened a few times in Emacs 21, but has been unreproducible
since.
@item If an interactive process is currently running, @kbd{M-!} doesn't work
@item Error if a glob doesn't expand due to a predicate
An error should be generated only if @code{eshell-error-if-no-glob} is
-non-nil.
+non-@code{nil}.
@item @samp{(+ RET SPC TAB} does not cause @code{indent-according-to-mode} to occur
This would allow for an ``output translators'', that take a function to
modify output with, and a target. Devise a syntax that works well with
-pipes, and can accomodate multiple functions (i.e., @samp{>'(upcase
+pipes, and can accommodate multiple functions (i.e., @samp{>'(upcase
regexp-quote)} or @samp{>'upcase}).
@item Allow Eshell to read/write to/from standard input and output
@item Write an alias for @command{less} that brings up a @code{view-mode} buffer
Such that the user can press @key{SPC} and @key{DEL}, and then @key{q}
-to return to Eshell. It would be equivalent to:
+to return to Eshell. It would be equivalent to:
@samp{X > #<buffer Y>; view-buffer #<buffer Y>}.
@item Make @code{eshell-mode} as much a full citizen as @code{shell-mode}
@printindex ky
@bye
+
+@ignore
+ arch-tag: 776409ba-cb15-42b9-b2b6-d2bdc7ebad01
+@end ignore