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