annotate doc/misc/eshell.texi @ 110322:f2f4402bbb2e

* tramp.texi (Inline methods): Remove "ssh1_old", "ssh2_old" and "fish" methods. (External methods): Remove "scp1_old" and "scp2_old" methods.
author Michael Albinus <michael.albinus@gmx.de>
date Mon, 13 Sep 2010 17:32:45 +0200
parents 60516122d066
children 417b1e4d63cd
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
84294
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1 \input texinfo @c -*-texinfo-*-
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2 @c %**start of header
84329
3d431f1997d8 (setfilename): Go up one more level to ../../info.
Glenn Morris <rgm@gnu.org>
parents: 84294
diff changeset
3 @setfilename ../../info/eshell
84294
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4 @settitle Eshell: The Emacs Shell
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5 @synindex vr fn
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6 @c %**end of header
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8 @copying
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9 This manual is for Eshell, the Emacs shell.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
10
109274
a91e94388547 Minor doc/misc/*.texi direntry fixes.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
11 Copyright @copyright{} 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
a91e94388547 Minor doc/misc/*.texi direntry fixes.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
12 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
84294
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
13
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
14 @quotation
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
15 Permission is granted to copy, distribute and/or modify this document
99709
6de181810d0f Relicense all texi files under FDL 1.3 or later.
Glenn Morris <rgm@gnu.org>
parents: 95937
diff changeset
16 under the terms of the GNU Free Documentation License, Version 1.3 or
84294
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
17 any later version published by the Free Software Foundation; with no
95937
6f0fce2c3559 Remove references to external license, since doclicense is included.
Glenn Morris <rgm@gnu.org>
parents: 95874
diff changeset
18 Invariant Sections, with the Front-Cover texts being ``A GNU Manual'',
6f0fce2c3559 Remove references to external license, since doclicense is included.
Glenn Morris <rgm@gnu.org>
parents: 95874
diff changeset
19 and with the Back-Cover Texts as in (a) below. A copy of the license
6f0fce2c3559 Remove references to external license, since doclicense is included.
Glenn Morris <rgm@gnu.org>
parents: 95874
diff changeset
20 is included in the section entitled ``GNU Free Documentation License''.
84294
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
21
95874
eafbd7a5c9be Update Back-Cover Text as per maintain.info.
Glenn Morris <rgm@gnu.org>
parents: 87903
diff changeset
22 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
eafbd7a5c9be Update Back-Cover Text as per maintain.info.
Glenn Morris <rgm@gnu.org>
parents: 87903
diff changeset
23 modify this GNU manual. Buying copies from the FSF supports it in
eafbd7a5c9be Update Back-Cover Text as per maintain.info.
Glenn Morris <rgm@gnu.org>
parents: 87903
diff changeset
24 developing GNU and promoting software freedom.''
84294
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
25 @end quotation
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
26 @end copying
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
27
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
28 @dircategory Emacs
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
29 @direntry
109274
a91e94388547 Minor doc/misc/*.texi direntry fixes.
Glenn Morris <rgm@gnu.org>
parents: 106815
diff changeset
30 * Eshell: (eshell). A command shell implemented in Emacs Lisp.
84294
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
31 @end direntry
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
32
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
33 @titlepage
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
34 @sp 4
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
35 @c The title is printed in a large font.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
36 @center @titlefont{User's Guide}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
37 @sp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
38 @center @titlefont{to}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
39 @sp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
40 @center @titlefont{Eshell: The Emacs Shell}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
41 @ignore
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
42 @sp 2
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
43 @center release 2.4
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
44 @c -release-
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
45 @end ignore
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
46 @sp 3
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
47 @center John Wiegley
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
48 @c -date-
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
49
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
50 @page
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
51 @vskip 0pt plus 1filll
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
52 @insertcopying
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
53 @end titlepage
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
54
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
55 @contents
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
56
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
57 @c ================================================================
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
58 @c The real text starts here
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
59 @c ================================================================
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
60
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
61 @ifnottex
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
62 @node Top, What is Eshell?, (dir), (dir)
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
63 @top Eshell
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
64
102059
9bcea07061a8 consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents: 100974
diff changeset
65 Eshell is a shell-like command interpretor
84294
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
66 implemented in Emacs Lisp. It invokes no external processes except for
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
67 those requested by the user. It is intended to be a functional
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
68 replacement for command shells such as @command{bash}, @command{zsh},
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
69 @command{rc}, or @command{4dos}; since Emacs itself is capable of
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
70 handling the sort of tasks accomplished by those tools.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
71 @c This manual is updated to release 2.4 of Eshell.
102059
9bcea07061a8 consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents: 100974
diff changeset
72
9bcea07061a8 consistently use @insertcopying, @direntry, @contents
Karl Berry <karl@gnu.org>
parents: 100974
diff changeset
73 @insertcopying
84294
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
74 @end ifnottex
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
75
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
76 @menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
77 * What is Eshell?:: A brief introduction to the Emacs Shell.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
78 * Command basics:: The basics of command usage.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
79 * Commands::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
80 * Arguments::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
81 * Input/Output::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
82 * Process control::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
83 * Extension modules::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
84 * Extras and Goodies::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
85 * Bugs and ideas:: Known problems, and future ideas.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
86 * GNU Free Documentation License:: The license for this documentation.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
87 * Concept Index::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
88 * Function and Variable Index::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
89 * Key Index::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
90 @end menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
91
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
92 @node What is Eshell?
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
93 @chapter What is Eshell?
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
94 @cindex what is Eshell?
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
95 @cindex Eshell, what it is
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
96
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
97 Eshell is a @dfn{command shell} written in Emacs Lisp. Everything it
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
98 does, it uses Emacs' facilities to do. This means that Eshell is as
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
99 portable as Emacs itself. It also means that cooperation with Lisp code
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
100 is natural and seamless.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
101
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
102 What is a command shell? To properly understand the role of a shell,
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
103 it's necessary to visualize what a computer does for you. Basically, a
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
104 computer is a tool; in order to use that tool, you must tell it what to
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
105 do---or give it ``commands.'' These commands take many forms, such as
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
106 clicking with a mouse on certain parts of the screen. But that is only
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
107 one form of command input.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
108
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
109 By far the most versatile way to express what you want the computer to
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
110 do is by using an abbreviated language called @dfn{script}. In
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
111 script, instead of telling the computer, ``list my files, please'',
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
112 one writes a standard abbreviated command word---@samp{ls}. Typing
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
113 @samp{ls} in a command shell is a script way of telling the computer
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
114 to list your files.@footnote{This is comparable to viewing the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
115 contents of a folder using a graphical display.}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
116
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
117 The real flexibility of this approach is apparent only when you realize
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
118 that there are many, many different ways to list files. Perhaps you
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
119 want them sorted by name, sorted by date, in reverse order, or grouped
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
120 by type. Most graphical browsers have simple ways to express this. But
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
121 what about showing only a few files, or only files that meet a certain
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
122 criteria? In very complex and specific situations, the request becomes
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
123 too difficult to express using a mouse or pointing device. It is just
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
124 these kinds of requests that are easily solved using a command shell.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
125
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
126 For example, what if you want to list every Word file on your hard
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
127 drive, larger than 100 kilobytes in size, and which hasn't been looked
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
128 at in over six months? That is a good candidate list for deletion, when
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
129 you go to clean up your hard drive. But have you ever tried asking your
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
130 computer for such a list? There is no way to do it! At least, not
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
131 without using a command shell.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
132
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
133 The role of a command shell is to give you more control over what your
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
134 computer does for you. Not everyone needs this amount of control, and
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
135 it does come at a cost: Learning the necessary script commands to
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
136 express what you want done. A complicated query, such as the example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
137 above, takes time to learn. But if you find yourself using your
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
138 computer frequently enough, it is more than worthwhile in the long run.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
139 Any tool you use often deserves the time spent learning to master it.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
140 @footnote{For the understandably curious, here is what that command
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
141 looks like: But don't let it fool you; once you know what's going on,
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
142 it's easier than it looks: @code{ls -lt **/*.doc(Lk+50aM+5)}.}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
143
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
144 @menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
145 * Contributors to Eshell:: People who have helped out!
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
146 @end menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
147
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
148 @node Contributors to Eshell
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
149 @section Contributors to Eshell
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
150 @cindex contributors
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
151 @cindex authors
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
152
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
153 Contributions to Eshell are welcome. I have limited time to work on
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
154 this project, but I will gladly add any code you contribute to me to
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
155 this package.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
156
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
157 The following persons have made contributions to Eshell.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
158
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
159 @itemize @bullet
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
160 @item
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
161 Eli Zaretskii made it possible for Eshell to run without requiring
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
162 asynchronous subprocess support. This is important for MS-DOS, which
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
163 does not have such support.@refill
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
164
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
165 @item
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
166 Miles Bader contributed many fixes during the port to Emacs 21.@refill
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
167
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
168 @item
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
169 Stefan Monnier fixed the things which bothered him, which of course made
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
170 things better for all.@refill
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
171
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
172 @item
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
173 Gerd Moellmann also helped to contribute bug fixes during the initial
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
174 integration with Emacs 21.@refill
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
175
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
176 @item
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
177 Alex Schroeder contributed code for interactively querying the user
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
178 before overwriting files.@refill
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
179
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
180 @item
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
181 Sudish Joseph helped with some XEmacs compatibility issues.@refill
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
182 @end itemize
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
183
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
184 Apart from these, a lot of people have sent suggestions, ideas,
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
185 requests, bug reports and encouragement. Thanks a lot! Without you
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
186 there would be no new releases of Eshell.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
187
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
188 @node Command basics
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
189 @chapter Basic overview
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
190
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
191 A command shell is a means of entering verbally-formed commands. This
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
192 is really all that it does, and every feature described in this manual
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
193 is a means to that end. Therefore, it's important to take firm hold on
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
194 exactly what a command is, and how it fits in the overall picture of
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
195 things.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
196
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
197 @menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
198 * Commands verbs:: Commands always begin with a verb.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
199 * Command arguments:: Some verbs require arguments.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
200 @end menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
201
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
202 @node Commands verbs
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
203 @section Commands verbs
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
204
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
205 Commands are expressed using @dfn{script}, a special shorthand language
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
206 computers can understand with no trouble. Script is an extremely simple
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
207 language; oddly enough, this is what makes it look so complicated!
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
208 Whereas normal languages use a variety of embellishments, the form of a
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
209 script command is always:
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
210
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
211 @example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
212 @var{verb} [@var{arguments}]
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
213 @end example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
214
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
215 The verb expresses what you want your computer to do. There are a fixed
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
216 number of verbs, although this number is usually quite large. On the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
217 author's computer, it reaches almost 1400 in number. But of course,
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
218 only a handful of these are really necessary.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
219
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
220 Sometimes, the verb is all that's written. A verb is always a single
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
221 word, usually related to the task it performs. @command{reboot} is a
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
222 good example. Entering that on GNU/Linux will reboot the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
223 computer---assuming you have sufficient privileges.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
224
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
225 Other verbs require more information. These are usually very capable
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
226 verbs, and must be told specifically what to do. The extra information
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
227 is given in the form of @dfn{arguments}. For example, the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
228 @command{echo} verb prints back whatever arguments you type. It
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
229 requires these arguments to know what to echo. A proper use of
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
230 @command{echo} looks like this:
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
231
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
232 @example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
233 echo This is an example of using echo!
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
234 @end example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
235
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
236 This script command causes the computer to echo back: ``This is an
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
237 example of using echo!''
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
238
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
239 Although command verbs are always simple words, like @command{reboot} or
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
240 @command{echo}, arguments may have a wide variety of forms. There are
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
241 textual arguments, numerical arguments---even Lisp arguments.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
242 Distinguishing these different types of arguments requires special
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
243 typing, for the computer to know exactly what you mean.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
244
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
245 @node Command arguments
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
246 @section Command arguments
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
247
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
248 Eshell recognizes several different kinds of command arguments:
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
249
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
250 @enumerate
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
251 @item Strings (also called textual arguments)
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
252 @item Numbers (floating point or integer)
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
253 @item Lisp lists
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
254 @item Lisp symbols
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
255 @item Emacs buffers
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
256 @item Emacs process handles
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
257 @end enumerate
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
258
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
259 Most users need to worry only about the first two. The third, Lisp lists,
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
260 occur very frequently, but almost always behind the scenes.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
261
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
262 Strings are the most common type of argument, and consist of nearly any
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
263 character. Special characters---those used by Eshell
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
264 specifically---must be preceded by a backslash (@samp{\}). When in doubt, it
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
265 is safe to add backslashes anywhere and everywhere.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
266
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
267 Here is a more complicated @command{echo} example:
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
268
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
269 @example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
270 echo A\ Multi-word\ Argument\ With\ A\ \$\ dollar
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
271 @end example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
272
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
273 Beyond this, things get a bit more complicated. While not beyond the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
274 reach of someone wishing to learn, it is definitely beyond the scope of
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
275 this manual to present it all in a simplistic manner. Get comfortable
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
276 with Eshell as a basic command invocation tool, and learn more about the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
277 commands on your system; then come back when it all sits more familiarly
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
278 on your mind. Have fun!
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
279
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
280 @node Commands
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
281 @chapter Commands
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
282
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
283 @menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
284 * Invocation::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
285 * Completion::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
286 * Aliases::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
287 * History::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
288 * Scripts::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
289 * Built-ins::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
290 @end menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
291
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
292 Essentially, a command shell is all about invoking commands---and
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
293 everything that entails. So understanding how Eshell invokes commands
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
294 is the key to comprehending how it all works.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
295
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
296 @node Invocation
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
297 @section Invocation
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
298
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
299 Unlike regular system shells, Eshell never invokes kernel functions
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
300 directly, such as @code{exec(3)}. Instead, it uses the Lisp functions
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
301 available in the Emacs Lisp library. It does this by transforming the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
302 command you specify into a callable Lisp form.@footnote{To see the Lisp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
303 form that will be invoked, type: @samp{eshell-parse-command "echo
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
304 hello"}}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
305
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
306 This transformation, from the string of text typed at the command
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
307 prompt, to the ultimate invocation of either a Lisp function or external
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
308 command, follows these steps:
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
309
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
310 @enumerate
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
311 @item Parse the command string into separate arguments.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
312 @item
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
313 @end enumerate
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
314
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
315 @node Completion
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
316 @section Completion
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
317
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
318 @node Aliases
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
319 @section Aliases
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
320
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
321 @node History
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
322 @section History
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
323
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
324 Eshell knows a few built-in variables:
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
325
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
326 @table @code
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
327
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
328 @item $+
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
329 @vindex $+
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
330 This variable always contains the current working directory.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
331
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
332 @item $-
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
333 @vindex $-
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
334 This variable always contains the previous working directory (the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
335 current working directory from before the last @code{cd} command).
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
336
106507
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
337 @item $_
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
338 @vindex $_
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
339 It refers to the last argument of the last command.
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
340
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
341 @item $$
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
342 @vindex $$
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
343 This is the result of the last command. In case of an external
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
344 command, it is @code{t} or @code{nil}.
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
345
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
346 @item $?
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
347 @vindex $?
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
348 This variable contains the exit code of the last command (0 or 1 for
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
349 Lisp functions, based on successful completion).
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
350
84294
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
351 @end table
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
352
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
353 @node Scripts
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
354 @section Scripts
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
355
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
356
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
357 @node Built-ins
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
358 @section Built-in commands
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
359
106507
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
360 Several commands are built-in in Eshell. In order to call the
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
361 external variant of a built-in command @code{foo}, you could call
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
362 @code{*foo}. Usually, this should not be necessary. You can check
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
363 what will be applied by the @code{which} command:
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
364
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
365 @example
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
366 ~ $ which ls
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
367 eshell/ls is a compiled Lisp function in `em-ls.el'
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
368 ~ $ which *ls
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
369 /bin/ls
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
370 @end example
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
371
108794
0aab456fe7bd * eshell.texi (Built-ins): Describe, how to disable a built-in command
Michael Albinus <michael.albinus@gmx.de>
parents: 106815
diff changeset
372 If you want to discard a given built-in command, you could declare an
0aab456fe7bd * eshell.texi (Built-ins): Describe, how to disable a built-in command
Michael Albinus <michael.albinus@gmx.de>
parents: 106815
diff changeset
373 alias, @ref{Aliases}. Eample:
0aab456fe7bd * eshell.texi (Built-ins): Describe, how to disable a built-in command
Michael Albinus <michael.albinus@gmx.de>
parents: 106815
diff changeset
374
0aab456fe7bd * eshell.texi (Built-ins): Describe, how to disable a built-in command
Michael Albinus <michael.albinus@gmx.de>
parents: 106815
diff changeset
375 @example
0aab456fe7bd * eshell.texi (Built-ins): Describe, how to disable a built-in command
Michael Albinus <michael.albinus@gmx.de>
parents: 106815
diff changeset
376 ~ $ which sudo
0aab456fe7bd * eshell.texi (Built-ins): Describe, how to disable a built-in command
Michael Albinus <michael.albinus@gmx.de>
parents: 106815
diff changeset
377 eshell/sudo is a compiled Lisp function in `em-unix.el'
0aab456fe7bd * eshell.texi (Built-ins): Describe, how to disable a built-in command
Michael Albinus <michael.albinus@gmx.de>
parents: 106815
diff changeset
378 ~ $ alias sudo '*sudo $*'
0aab456fe7bd * eshell.texi (Built-ins): Describe, how to disable a built-in command
Michael Albinus <michael.albinus@gmx.de>
parents: 106815
diff changeset
379 ~ $ which sudo
0aab456fe7bd * eshell.texi (Built-ins): Describe, how to disable a built-in command
Michael Albinus <michael.albinus@gmx.de>
parents: 106815
diff changeset
380 sudo is an alias, defined as "*sudo $*"
0aab456fe7bd * eshell.texi (Built-ins): Describe, how to disable a built-in command
Michael Albinus <michael.albinus@gmx.de>
parents: 106815
diff changeset
381 @end example
0aab456fe7bd * eshell.texi (Built-ins): Describe, how to disable a built-in command
Michael Albinus <michael.albinus@gmx.de>
parents: 106815
diff changeset
382
106507
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
383 Some of the built-in commands have a special behaviour in Eshell:
84294
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
384
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
385 @table @code
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
386
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
387 @item cd
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
388 @findex cd
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
389 This command changes the current working directory. Usually, it is
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
390 invoked as @samp{cd foo} where @file{foo} is the new working
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
391 directory. But @code{cd} knows about a few special arguments:
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
392
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
393 When it receives no argument at all, it changes to the home directory.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
394
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
395 Giving the command @samp{cd -} changes back to the previous working
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
396 directory (this is the same as @samp{cd $-}).
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
397
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
398 The command @samp{cd =} shows the directory stack. Each line is
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
399 numbered.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
400
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
401 With @samp{cd =foo}, Eshell searches the directory stack for a
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
402 directory matching the regular expression @samp{foo} and changes to
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
403 that directory.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
404
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
405 With @samp{cd -42}, you can access the directory stack by number.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
406
106507
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
407 @item history
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
408 @findex history
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
409 The @samp{history} command shows all commands kept in the history ring
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
410 as numbered list. If the history ring contains
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
411 @code{eshell-history-size} commands, those numbers change after every
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
412 command invocation, therefore the @samp{history} command shall be
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
413 applied before using the expansion mechanism with history numbers.
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
414
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
415 The n-th entry of the history ring can be applied with the @samp{!n}
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
416 command. If @code{n} is negative, the entry is counted from the end
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
417 of the history ring.
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
418
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
419 @samp{!foo} expands to the last command beginning with @code{foo}, and
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
420 @samp{!?foo} to the last command containing @code{foo}. The n-th
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
421 argument of the last command beginning with @code{foo} is accessible
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
422 by @code{!foo:n}.
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
423
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
424 @item su
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
425 @findex su
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
426 @itemx sudo
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
427 @findex sudo
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
428 @code{su} and @code{sudo} work as expected: they apply the following
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
429 commands (@code{su}), or the command being an argument (@code{sudo})
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
430 under the permissions of somebody else.
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
431
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
432 This does not work only on
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
433 the local host, but even on a remote one, when
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
434 @code{default-directory} is a remote file name. The necessary
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
435 proxy configuration of Tramp is performed
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
436 @ifinfo
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
437 automatically, @ref{Multi-hops, , , tramp}.
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
438 @end ifinfo
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
439 @ifnotinfo
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
440 automatically.
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
441 @end ifnotinfo
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
442 Example:
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
443
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
444 @example
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
445 ~ $ cd /ssh:otherhost:/etc
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
446 /ssh:user@@otherhost:/etc $ sudo find-file shadow
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
447 @end example
9506b5eee678 * eshell.texi (History): Add the other built-in variables.
Michael Albinus <michael.albinus@gmx.de>
parents: 102059
diff changeset
448
84294
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
449 @end table
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
450
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
451
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
452 @node Arguments
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
453 @chapter Arguments
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
454
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
455 @menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
456 * The Parser::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
457 * Variables::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
458 * Substitution::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
459 * Globbing::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
460 * Predicates::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
461 @end menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
462
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
463 @node The Parser
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
464 @section The Parser
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
465
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
466 @node Variables
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
467 @section Variables
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
468
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
469 @node Substitution
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
470 @section Substitution
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
471
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
472 @node Globbing
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
473 @section Globbing
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
474
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
475 @node Predicates
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
476 @section Predicates
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
477
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
478
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
479 @node Input/Output
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
480 @chapter Input/Output
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
481
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
482 @node Process control
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
483 @chapter Process control
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
484
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
485
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
486 @node Extension modules
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
487 @chapter Extension modules
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
488
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
489 @menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
490 * Writing a module::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
491 * Module testing::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
492 * Directory handling::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
493 * Key rebinding::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
494 * Smart scrolling::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
495 * Terminal emulation::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
496 * Built-in UNIX commands::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
497 @end menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
498
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
499 @node Writing a module
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
500 @section Writing a module
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
501
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
502 @node Module testing
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
503 @section Module testing
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
504
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
505 @node Directory handling
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
506 @section Directory handling
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
507
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
508 @node Key rebinding
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
509 @section Key rebinding
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
510
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
511 @node Smart scrolling
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
512 @section Smart scrolling
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
513
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
514 @node Terminal emulation
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
515 @section Terminal emulation
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
516
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
517 @node Built-in UNIX commands
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
518 @section Built-in UNIX commands
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
519
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
520
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
521 @node Extras and Goodies
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
522 @chapter Extras and Goodies
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
523
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
524 @node Bugs and ideas
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
525 @chapter Bugs and ideas
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
526 @cindex reporting bugs and ideas
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
527 @cindex bugs, how to report them
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
528 @cindex author, how to reach
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
529 @cindex email to the author
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
530 @cindex FAQ
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
531 @cindex problems, list of common
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
532
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
533 If you find a bug or misfeature, don't hesitate to let me know! Send
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
534 email to @email{johnw@@gnu.org}. Feature requests should also be sent
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
535 there. I prefer discussing one thing at a time. If you find several
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
536 unrelated bugs, please report them separately.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
537
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
538 If you have ideas for improvements, or if you have written some
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
539 extensions to this package, I would like to hear from you. I hope you
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
540 find this package useful!
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
541
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
542 @menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
543 * Known problems::
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
544 @end menu
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
545
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
546 @node Known problems
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
547 @section Known problems
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
548 @cindex known bugs
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
549 @cindex bugs, known
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
550
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
551 Below is complete list of known problems with Eshell version 2.4.2,
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
552 which is the version included with Emacs 22.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
553
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
554 @table @asis
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
555 @item Documentation incomplete
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
556
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
557 @item Differentiate between aliases and functions
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
558
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
559 Allow for a bash-compatible syntax, such as:
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
560
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
561 @example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
562 alias arg=blah
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
563 function arg () @{ blah $* @}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
564 @end example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
565
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
566 @item @samp{for i in 1 2 3 @{ grep -q a b && *echo has it @} | wc -l} outputs result after prompt
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
567
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
568 In fact, piping to a process from a looping construct doesn't work in
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
569 general. If I change the call to @code{eshell-copy-handles} in
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
570 @code{eshell-rewrite-for-command} to use @code{eshell-protect}, it seems
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
571 to work, but the output occurs after the prompt is displayed. The whole
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
572 structured command thing is too complicated at present.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
573
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
574 @item Error with @command{bc} in @code{eshell-test}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
575
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
576 On some XEmacs system, the subprocess interaction test fails
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
577 inexplicably, although @command{bc} works fine at the command prompt.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
578
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
579 @item Eshell does not delete @file{*Help*} buffers in XEmacs 21.1.8+
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
580
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
581 In XEmacs 21.1.8, the @file{*Help*} buffer has been renamed such that
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
582 multiple instances of the @file{*Help*} buffer can exist.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
583
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
584 @item Pcomplete sometimes gets stuck
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
585
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
586 You press @key{TAB}, but no completions appear, even though the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
587 directory has matching files. This behavior is rare.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
588
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
589 @item @samp{grep python $<rpm -qa>} doesn't work, but using @samp{*grep} does
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
590
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
591 This happens because the @code{grep} Lisp function returns immediately,
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
592 and then the asynchronous @command{grep} process expects to examine the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
593 temporary file, which has since been deleted.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
594
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
595 @item Problem with C-r repeating text
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
596
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
597 If the text @emph{before point} reads "./run", and you type @kbd{C-r r u
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
598 n}, it will repeat the line for every character typed.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
599
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
600 @item Backspace doesn't scroll back after continuing (in smart mode)
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
601
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
602 Hitting space during a process invocation, such as @command{make}, will
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
603 cause it to track the bottom of the output; but backspace no longer
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
604 scrolls back.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
605
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
606 @item It's not possible to fully @code{unload-feature} Eshell
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
607
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
608 @item Menu support was removed, but never put back
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
609
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
610 @item Using C-p and C-n with rebind gets into a locked state
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
611
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
612 This happened a few times in Emacs 21, but has been unreproducible
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
613 since.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
614
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
615 @item If an interactive process is currently running, @kbd{M-!} doesn't work
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
616
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
617 @item Use a timer instead of @code{sleep-for} when killing child processes
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
618
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
619 @item Piping to a Lisp function is not supported
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
620
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
621 Make it so that the Lisp command on the right of the pipe is repeatedly
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
622 called with the input strings as arguments. This will require changing
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
623 @code{eshell-do-pipeline} to handle non-process targets.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
624
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
625 @item Input redirection is not supported
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
626
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
627 See the above entry.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
628
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
629 @item Problem running @command{less} without arguments on Windows
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
630
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
631 The result in the Eshell buffer is:
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
632
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
633 @example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
634 Spawning child process: invalid argument
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
635 @end example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
636
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
637 Also a new @command{less} buffer was created with nothing in it@dots{}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
638 (presumably this holds the output of @command{less}).
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
639
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
640 If @command{less.exe} is invoked from the Eshell command line, the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
641 expected output is written to the buffer.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
642
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
643 Note that this happens on NT-Emacs 20.6.1 on Windows 2000. The term.el
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
644 package and the supplied shell both use the @command{cmdproxy} program
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
645 for running shells.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
646
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
647 @item Implement @samp{-r}, @samp{-n} and @samp{-s} switches for @command{cp}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
648
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
649 @item Make @kbd{M-5 M-x eshell} switch to ``*eshell<5>*'', creating if need be
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
650
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
651 @item @samp{mv @var{dir} @var{file}.tar} does not remove directories
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
652
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
653 This is because the tar option --remove-files doesn't do so. Should it
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
654 be Eshell's job?
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
655
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
656 @item Bind @code{standard-output} and @code{standard-error}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
657
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
658 This would be so that if a Lisp function calls @code{print}, everything
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
659 will happen as it should (albeit slowly).
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
660
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
661 @item When an extension module fails to load, @samp{cd /} gives a Lisp error
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
662
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
663 @item If a globbing pattern returns one match, should it be a list?
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
664
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
665 @item Make sure syntax table is correct in Eshell mode
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
666
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
667 So that @kbd{M-DEL} acts in a predictable manner, etc.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
668
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
669 @item Allow all Eshell buffers to share the same history and list-dir
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
670
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
671 @item There is a problem with script commands that output to @file{/dev/null}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
672
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
673 If a script file, somewhere in the middle, uses @samp{> /dev/null},
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
674 output from all subsequent commands is swallowed.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
675
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
676 @item Split up parsing of text after @samp{$} in @file{esh-var.el}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
677
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
678 Make it similar to the way that @file{esh-arg.el} is structured.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
679 Then add parsing of @samp{$[?\n]}.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
680
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
681 @item After pressing @kbd{M-RET}, redisplay before running the next command
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
682
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
683 @item Argument predicates and modifiers should work anywhere in a path
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
684
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
685 @example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
686 /usr/local/src/editors/vim $ vi **/CVS(/)/Root(.)
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
687 Invalid regexp: "Unmatched ( or \\("
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
688 @end example
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
689
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
690 With @command{zsh}, the glob above expands to all files named
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
691 @file{Root} in directories named @file{CVS}.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
692
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
693 @item Typing @samp{echo $@{locate locate@}/bin<TAB>} results in a Lisp error
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
694
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
695 Perhaps it should interpolate all permutations, and make that the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
696 globbing result, since otherwise hitting return here will result in
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
697 ``(list of filenames)/bin'', which is never valuable. Thus, one could
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
698 @command{cat} only C backup files by using @samp{ls $@{identity *.c@}~}.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
699 In that case, having an alias command name @command{glob} for
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
700 @command{identity} would be useful.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
701
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
702 @item Once symbolic mode is supported for @command{umask}, implement @command{chmod} in Lisp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
703
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
704 @item Create @code{eshell-expand-file-name}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
705
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
706 This would use a data table to transform things such as @samp{~+},
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
707 @samp{...}, etc.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
708
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
709 @item Abstract @file{em-smart.el} into @file{smart-scroll.el}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
710
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
711 It only really needs: to be hooked onto the output filter and the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
712 pre-command hook, and to have the input-end and input-start markers.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
713 And to know whether the last output group was ``successful.''
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
714
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
715 @item Allow for fully persisting the state of Eshell
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
716
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
717 This would include: variables, history, buffer, input, dir stack, etc.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
718
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
719 @item Implement D as an argument predicate
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
720
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
721 It means that files beginning with a dot should be included in the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
722 glob match.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
723
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
724 @item A comma in a predicate list should mean OR
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
725
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
726 At the moment, this is not supported.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
727
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
728 @item Error if a glob doesn't expand due to a predicate
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
729
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
730 An error should be generated only if @code{eshell-error-if-no-glob} is
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
731 non-@code{nil}.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
732
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
733 @item @samp{(+ RET SPC TAB} does not cause @code{indent-according-to-mode} to occur
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
734
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
735 @item Create @code{eshell-auto-accumulate-list}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
736
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
737 This is a list of commands for which, if the user presses @kbd{RET}, the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
738 text is staged as the next Eshell command, rather than being sent to the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
739 current interactive process.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
740
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
741 @item Display file and line number if an error occurs in a script
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
742
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
743 @item @command{wait} doesn't work with process ids at the moment
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
744
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
745 @item Enable the direct-to-process input code in @file{em-term.el}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
746
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
747 @item Problem with repeating @samp{echo $@{find /tmp@}}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
748
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
749 With smart display active, if @kbd{RET} is held down, after a while it
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
750 can't keep up anymore and starts outputting blank lines. It only
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
751 happens if an asynchronous process is involved@dots{}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
752
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
753 I think the problem is that @code{eshell-send-input} is resetting the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
754 input target location, so that if the asynchronous process is not done
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
755 by the time the next @kbd{RET} is received, the input processor thinks
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
756 that the input is meant for the process; which, when smart display is
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
757 enabled, will be the text of the last command line! That is a bug in
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
758 itself.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
759
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
760 In holding down @kbd{RET} while an asynchronous process is running,
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
761 there will be a point in between termination of the process, and the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
762 running of @code{eshell-post-command-hook}, which would cause
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
763 @code{eshell-send-input} to call @code{eshell-copy-old-input}, and then
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
764 process that text as a command to be run after the process. Perhaps
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
765 there should be a way of killing pending input between the death of the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
766 process, and the @code{post-command-hook}.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
767
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
768 @item Allow for a more aggressive smart display mode
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
769
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
770 Perhaps toggled by a command, that makes each output block a smart
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
771 display block.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
772
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
773 @item Create more meta variables
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
774
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
775 @table @samp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
776 @item $!
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
777 The reason for the failure of the last disk command, or the text of the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
778 last Lisp error.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
779
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
780 @item $=
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
781 A special associate array, which can take references of the form
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
782 @samp{$=[REGEXP]}. It indexes into the directory ring.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
783 @end table
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
784
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
785 @item Eshell scripts can't execute in the background
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
786
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
787 @item Support zsh's ``Parameter Expansion'' syntax, i.e. @samp{$@{@var{name}:-@var{val}@}}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
788
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
789 @item Write an @command{info} alias that can take arguments
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
790
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
791 So that the user can enter @samp{info chmod}, for example.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
792
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
793 @item Create a mode @code{eshell-browse}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
794
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
795 It would treat the Eshell buffer as a outline. Collapsing the outline
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
796 hides all of the output text. Collapsing again would show only the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
797 first command run in each directory
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
798
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
799 @item Allow other revisions of a file to be referenced using @samp{file@{rev@}}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
800
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
801 This would be expanded by @code{eshell-expand-file-name} (see above).
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
802
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
803 @item Print ``You have new mail'' when the ``Mail'' icon is turned on
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
804
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
805 @item Implement @kbd{M-|} for Eshell
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
806
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
807 @item Implement input redirection
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
808
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
809 If it's a Lisp function, input redirection implies @command{xargs} (in a
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
810 way@dots{}). If input redirection is added, also update the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
811 @code{file-name-quote-list}, and the delimiter list.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
812
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
813 @item Allow @samp{#<@var{word} @var{arg}>} as a generic syntax
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
814
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
815 With the handling of @emph{word} specified by an
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
816 @code{eshell-special-alist}.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
817
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
818 @item In @code{eshell-veal-using-options}, allow a @code{:complete} tag
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
819
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
820 It would be used to provide completion rules for that command. Then the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
821 macro will automagically define the completion function.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
822
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
823 @item For @code{eshell-command-on-region}, apply redirections to the result
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
824
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
825 So that @samp{+ > 'blah} would cause the result of the @code{+} (using
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
826 input from the current region) to be inserting into the symbol
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
827 @code{blah}.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
828
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
829 If an external command is being invoked, the input is sent as standard
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
830 input, as if a @samp{cat <region> |} had been invoked.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
831
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
832 If a Lisp command, or an alias, is invoked, then if the line has no
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
833 newline characters, it is divided by whitespace and passed as arguments
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
834 to the Lisp function. Otherwise, it is divided at the newline
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
835 characters. Thus, invoking @code{+} on a series of numbers will add
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
836 them; @code{min} would display the smallest figure, etc.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
837
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
838 @item Write @code{eshell-script-mode} as a minor mode
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
839
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
840 It would provide syntax, abbrev, highlighting and indenting support like
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
841 @code{emacs-lisp-mode} and @code{shell-mode}.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
842
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
843 @item In the history mechanism, finish the @command{bash}-style support
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
844
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
845 This means @samp{!n}, @samp{!#}, @samp{!:%}, and @samp{!:1-} as separate
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
846 from @samp{!:1*}.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
847
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
848 @item Support the -n command line option for @command{history}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
849
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
850 @item Implement @command{fc} in Lisp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
851
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
852 @item Specifying a frame as a redirection target should imply the currently active window's buffer
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
853
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
854 @item Implement @samp{>@var{func-or-func-list}}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
855
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
856 This would allow for an ``output translators'', that take a function to
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
857 modify output with, and a target. Devise a syntax that works well with
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
858 pipes, and can accommodate multiple functions (i.e., @samp{>'(upcase
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
859 regexp-quote)} or @samp{>'upcase}).
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
860
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
861 @item Allow Eshell to read/write to/from standard input and output
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
862
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
863 This would be optional, rather than always using the Eshell buffer.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
864 This would allow it to be run from the command line (perhaps).
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
865
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
866 @item Write a @command{help} command
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
867
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
868 It would call subcommands with @option{--help}, or @option{-h} or
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
869 @option{/?}, as appropriate.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
870
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
871 @item Implement @command{stty} in Lisp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
872
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
873 @item Support @command{rc}'s matching operator, e.g. @samp{~ (@var{list}) @var{regexp}}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
874
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
875 @item Implement @command{bg} and @command{fg} as editors of @code{eshell-process-list}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
876
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
877 Using @command{bg} on a process that is already in the background does
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
878 nothing. Specifying redirection targets replaces (or adds) to the list
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
879 current being used.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
880
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
881 @item Have @command{jobs} print only the processes for the current shell
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
882
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
883 @item How can Eshell learn if a background process has requested input?
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
884
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
885 @item Support @samp{2>&1} and @samp{>&} and @samp{2>} and @samp{|&}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
886
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
887 The syntax table for parsing these should be customizable, such that the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
888 user could change it to use rc syntax: @samp{>[2=1]}.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
889
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
890 @item Allow @samp{$_[-1]}, which would indicate the last element of the array
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
891
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
892 @item Make @samp{$x[*]} equal to listing out the full contents of @samp{x}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
893
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
894 Return them as a list, so that @samp{$_[*]} is all the arguments of the
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
895 last command.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
896
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
897 @item Copy ANSI code handling from @file{term.el} into @file{em-term.el}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
898
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
899 Make it possible for the user to send char-by-char to the underlying
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
900 process. Ultimately, I should be able to move away from using term.el
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
901 altogether, since everything but the ANSI code handling is already part
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
902 of Eshell. Then, things would work correctly on MS-Windows as well
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
903 (which doesn't have @file{/bin/sh}, although @file{term.el} tries to use
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
904 it).
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
905
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
906 @item Make the shell spawning commands be visual
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
907
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
908 That is, make (@command{su}, @command{bash}, @command{telnet},
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
909 @command{rlogin}, @command{rsh}, etc.) be part of
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
910 @code{eshell-visual-commands}. The only exception is if the shell is
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
911 being used to invoke a single command. Then, the behavior should be
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
912 based on what that command is.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
913
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
914 @item Create a smart viewing command named @command{open}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
915
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
916 This would search for some way to open its argument (similar to opening
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
917 a file in the Windows Explorer).
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
918
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
919 @item Alias @command{read} to be the same as @command{open}, only read-only
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
920
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
921 @item Write a @command{tail} command which uses @code{view-file}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
922
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
923 It would move point to the end of the buffer, and then turns on
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
924 auto-revert mode in that buffer at frequent intervals---and a
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
925 @command{head} alias which assumes an upper limit of
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
926 @code{eshell-maximum-line-length} characters per line.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
927
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
928 @item Make @command{dgrep} load @code{dired}, mark everything, then invoke @code{dired-do-search}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
929
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
930 @item Write mesh.c
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
931
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
932 This would run Emacs with the appropriate arguments to invoke Eshell
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
933 only. That way, it could be listed as a login shell.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
934
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
935 @item Use an intangible @code{PS2} string for multi-line input prompts
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
936
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
937 @item Auto-detect when a command is visual, by checking @code{TERMCAP} usage
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
938
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
939 @item The first keypress after @kbd{M-x watson} triggers `eshell-send-input'
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
940
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
941 @item Make @kbd{/} electric
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
942
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
943 So that it automatically expands and corrects pathnames. Or make
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
944 pathname completion for Pcomplete auto-expand @samp{/u/i/std<TAB>} to
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
945 @samp{/usr/include/std<TAB>}.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
946
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
947 @item Write the @command{pushd} stack to disk along with @code{last-dir-ring}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
948
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
949 @item Add options to @code{eshell/cat} which would allow it to sort and uniq
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
950
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
951 @item Implement @command{wc} in Lisp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
952
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
953 Add support for counting sentences, paragraphs, pages, etc.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
954
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
955 @item Once piping is added, implement @command{sort} and @command{uniq} in Lisp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
956
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
957 @item Implement @command{touch} in Lisp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
958
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
959 @item Implement @command{comm} in Lisp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
960
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
961 @item Implement an @command{epatch} command in Lisp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
962
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
963 This would call @code{ediff-patch-file}, or @code{ediff-patch-buffer},
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
964 depending on its argument.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
965
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
966 @item Have an option such that @samp{ls -l} generates a dired buffer
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
967
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
968 @item Write a version of @command{xargs} based on command rewriting
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
969
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
970 That is, @samp{find X | xargs Y} would be indicated using @samp{Y
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
971 $@{find X@}}. Maybe @code{eshell-do-pipelines} could be changed to
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
972 perform this on-thy-fly rewriting.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
973
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
974 @item Write an alias for @command{less} that brings up a @code{view-mode} buffer
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
975
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
976 Such that the user can press @key{SPC} and @key{DEL}, and then @key{q}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
977 to return to Eshell. It would be equivalent to:
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
978 @samp{X > #<buffer Y>; view-buffer #<buffer Y>}.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
979
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
980 @item Make @code{eshell-mode} as much a full citizen as @code{shell-mode}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
981
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
982 Everywhere in Emacs where @code{shell-mode} is specially noticed, add
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
983 @code{eshell-mode} there.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
984
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
985 @item Permit the umask to be selectively set on a @command{cp} target
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
986
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
987 @item Problem using @kbd{M-x eshell} after using @code{eshell-command}
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
988
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
989 If the first thing that I do after entering Emacs is to run
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
990 @code{eshell-command} and invoke @command{ls}, and then use @kbd{M-x
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
991 eshell}, it doesn't display anything.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
992
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
993 @item @kbd{M-RET} during a long command (using smart display) doesn't work
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
994
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
995 Since it keeps the cursor up where the command was invoked.
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
996
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
997 @end table
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
998
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
999 @node GNU Free Documentation License
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1000 @appendix GNU Free Documentation License
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1001 @include doclicense.texi
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1002
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1003 @node Concept Index
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1004 @unnumbered Concept Index
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1005
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1006 @printindex cp
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1007
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1008 @node Function and Variable Index
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1009 @unnumbered Function and Variable Index
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1010
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1011 @printindex fn
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1012
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1013 @node Key Index
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1014 @unnumbered Key Index
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1015
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1016 @printindex ky
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1017 @bye
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1018
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1019 @ignore
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1020 arch-tag: 776409ba-cb15-42b9-b2b6-d2bdc7ebad01
acb87a4be931 Move here from ../../man
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
1021 @end ignore