aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman2001-03-04 07:07:00 +0000
committerRichard M. Stallman2001-03-04 07:07:00 +0000
commit304724c2ad040a95cb75480918e690a3284a737b (patch)
tree4106cfcda17359115ea32ed3959fb6375c5d503b
parent91dc757eba5edf3f7c07b8e78349e0011e6a0e4c (diff)
downloademacs-304724c2ad040a95cb75480918e690a3284a737b.tar.gz
emacs-304724c2ad040a95cb75480918e690a3284a737b.zip
Minor fixes.
-rw-r--r--man/eshell.texi37
1 files changed, 15 insertions, 22 deletions
diff --git a/man/eshell.texi b/man/eshell.texi
index 4c6ec02ad42..af56d765c09 100644
--- a/man/eshell.texi
+++ b/man/eshell.texi
@@ -1,6 +1,6 @@
1\input texinfo @c -*-texinfo-*- 1\input texinfo @c -*-texinfo-*-
2 2
3@c "@(#)$Name: $:$Id: eshell.texi,v 1.8 2001/01/26 06:19:25 johnw Exp $" 3@c "@(#)$Name: $:$Id: eshell.texi,v 1.9 2001/01/28 18:48:45 eliz Exp $"
4 4
5@c Documentation for Eshell: The Emacs Shell. 5@c Documentation for Eshell: The Emacs Shell.
6@c Copyright (C) 1999, 2000 Free Software Foundation, Inc. 6@c Copyright (C) 1999, 2000 Free Software Foundation, Inc.
@@ -151,18 +151,17 @@ is natural and seamless.
151What is a command shell? To properly understand the role of a shell, 151What is a command shell? To properly understand the role of a shell,
152it's necessary to visualize what a computer does for you. Basically, a 152it's necessary to visualize what a computer does for you. Basically, a
153computer is a tool; in order to use that tool, you must tell it what to 153computer is a tool; in order to use that tool, you must tell it what to
154do---or give it ``commands''. These commands take many forms, such as 154do---or give it ``commands.'' These commands take many forms, such as
155clicking with a mouse on certain parts of the screen. But that is only 155clicking with a mouse on certain parts of the screen. But that is only
156one form of command input. 156one form of command input.
157 157
158By far the most versatile way to express what you want the computer to 158By far the most versatile way to express what you want the computer to
159do is by using an abbreviated language called @dfn{script}. In script, 159do is by using an abbreviated language called @dfn{script}. In
160instead of telling the computer, ``list my files, please'', one writes 160script, instead of telling the computer, ``list my files, please'',
161just ``list''. In fact, this command is so commonly used that it is 161one writes a standard abbreviated command word---@samp{ls}. Typing
162abbreviated to ``ls''. Typing @kbd{ls} in a command shell is a script 162@samp{ls} in a command shell is a script way of telling the computer
163way of telling the computer to list your files.@footnote{This is 163to list your files.@footnote{This is comparable to viewing the
164comparable to viewing the contents of a folder using a graphical 164contents of a folder using a graphical display.}
165display.}
166 165
167The real flexibility of this approach is apparent only when you realize 166The real flexibility of this approach is apparent only when you realize
168that there are many, many different ways to list files. Perhaps you 167that there are many, many different ways to list files. Perhaps you
@@ -451,7 +450,7 @@ Whereas normal languages use a variety of embellishments, the form of a
451script command is always: 450script command is always:
452 451
453@example 452@example
454 VERB [ARGUMENTS] 453@var{verb} [@var{arguments}]
455@end example 454@end example
456 455
457The verb expresses what you want your computer to do. There are a fixed 456The verb expresses what you want your computer to do. There are a fixed
@@ -461,8 +460,8 @@ only a handful of these are really necessary.
461 460
462Sometimes, the verb is all that's written. A verb is always a single 461Sometimes, the verb is all that's written. A verb is always a single
463word, usually related to the task it performs. @command{reboot} is a 462word, usually related to the task it performs. @command{reboot} is a
464good example. Entering that on Linux will cause your computer to 463good example. Entering that on GNU/Linux will reboot the
465reboot---assuming you have sufficient privileges. 464computer---assuming you have sufficient privileges.
466 465
467Other verbs require more information. These are usually very capable 466Other verbs require more information. These are usually very capable
468verbs, and must be told specifically what to do. The extra information 467verbs, and must be told specifically what to do. The extra information
@@ -472,11 +471,11 @@ requires these arguments to know what to echo. A proper use of
472@command{echo} looks like this: 471@command{echo} looks like this:
473 472
474@example 473@example
475 echo This is an example of using echo! 474echo This is an example of using echo!
476@end example 475@end example
477 476
478This script command causes the computer to echo back: ``This is an 477This script command causes the computer to echo back: ``This is an
479example of using echo!''. 478example of using echo!''
480 479
481Although command verbs are always simple words, like @command{reboot} or 480Although command verbs are always simple words, like @command{reboot} or
482@command{echo}, arguments may have a wide variety of forms. There are 481@command{echo}, arguments may have a wide variety of forms. There are
@@ -509,7 +508,7 @@ is safe to add backslashes anywhere and everywhere.
509Here is a more complicated @command{echo} example: 508Here is a more complicated @command{echo} example:
510 509
511@example 510@example
512 echo A\ Multi-word\ Argument\ With\ A\ \$\ dollar 511echo A\ Multi-word\ Argument\ With\ A\ \$\ dollar
513@end example 512@end example
514 513
515Beyond this, things get a bit more complicated. While not beyond the 514Beyond this, things get a bit more complicated. While not beyond the
@@ -794,12 +793,6 @@ globbing result, since otherwise hitting return here will result in
794In that case, having an alias command name @command{glob} for 793In that case, having an alias command name @command{glob} for
795@command{identity} would be useful. 794@command{identity} would be useful.
796 795
797@item Fix `file-name-all-completions' for XEmacs on MS-Windows
798
799Make sure it returns directory names terminated by
800@code{directory-sep-char} (which is initialized to be @samp{?/}), rather
801than backslash.
802
803@item Once symbolic mode is supported for @command{umask}, implement @command{chmod} in Lisp 796@item Once symbolic mode is supported for @command{umask}, implement @command{chmod} in Lisp
804 797
805@item Create @code{eshell-expand-file-name} 798@item Create @code{eshell-expand-file-name}
@@ -811,7 +804,7 @@ This would use a data table to transform things such as @samp{~+},
811 804
812It only really needs: to be hooked onto the output filter and the 805It only really needs: to be hooked onto the output filter and the
813pre-command hook, and to have the input-end and input-start markers. 806pre-command hook, and to have the input-end and input-start markers.
814And to know whether the last output group was ``successful''. 807And to know whether the last output group was ``successful.''
815 808
816@item Allow for fully persisting the state of Eshell 809@item Allow for fully persisting the state of Eshell
817 810