diff options
| author | Richard M. Stallman | 2001-03-04 07:07:00 +0000 |
|---|---|---|
| committer | Richard M. Stallman | 2001-03-04 07:07:00 +0000 |
| commit | 304724c2ad040a95cb75480918e690a3284a737b (patch) | |
| tree | 4106cfcda17359115ea32ed3959fb6375c5d503b | |
| parent | 91dc757eba5edf3f7c07b8e78349e0011e6a0e4c (diff) | |
| download | emacs-304724c2ad040a95cb75480918e690a3284a737b.tar.gz emacs-304724c2ad040a95cb75480918e690a3284a737b.zip | |
Minor fixes.
| -rw-r--r-- | man/eshell.texi | 37 |
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. | |||
| 151 | What is a command shell? To properly understand the role of a shell, | 151 | What is a command shell? To properly understand the role of a shell, |
| 152 | it's necessary to visualize what a computer does for you. Basically, a | 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 | 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 | 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 | 155 | clicking with a mouse on certain parts of the screen. But that is only |
| 156 | one form of command input. | 156 | one form of command input. |
| 157 | 157 | ||
| 158 | By far the most versatile way to express what you want the computer to | 158 | By far the most versatile way to express what you want the computer to |
| 159 | do is by using an abbreviated language called @dfn{script}. In script, | 159 | do is by using an abbreviated language called @dfn{script}. In |
| 160 | instead of telling the computer, ``list my files, please'', one writes | 160 | script, instead of telling the computer, ``list my files, please'', |
| 161 | just ``list''. In fact, this command is so commonly used that it is | 161 | one writes a standard abbreviated command word---@samp{ls}. Typing |
| 162 | abbreviated 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 |
| 163 | way of telling the computer to list your files.@footnote{This is | 163 | to list your files.@footnote{This is comparable to viewing the |
| 164 | comparable to viewing the contents of a folder using a graphical | 164 | contents of a folder using a graphical display.} |
| 165 | display.} | ||
| 166 | 165 | ||
| 167 | The real flexibility of this approach is apparent only when you realize | 166 | 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 | 167 | that 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 | |||
| 451 | script command is always: | 450 | script 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 | ||
| 457 | The verb expresses what you want your computer to do. There are a fixed | 456 | The 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 | ||
| 462 | Sometimes, the verb is all that's written. A verb is always a single | 461 | Sometimes, the verb is all that's written. A verb is always a single |
| 463 | word, usually related to the task it performs. @command{reboot} is a | 462 | word, usually related to the task it performs. @command{reboot} is a |
| 464 | good example. Entering that on Linux will cause your computer to | 463 | good example. Entering that on GNU/Linux will reboot the |
| 465 | reboot---assuming you have sufficient privileges. | 464 | computer---assuming you have sufficient privileges. |
| 466 | 465 | ||
| 467 | Other verbs require more information. These are usually very capable | 466 | Other verbs require more information. These are usually very capable |
| 468 | verbs, and must be told specifically what to do. The extra information | 467 | verbs, 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! | 474 | echo This is an example of using echo! |
| 476 | @end example | 475 | @end example |
| 477 | 476 | ||
| 478 | This script command causes the computer to echo back: ``This is an | 477 | This script command causes the computer to echo back: ``This is an |
| 479 | example of using echo!''. | 478 | example of using echo!'' |
| 480 | 479 | ||
| 481 | Although command verbs are always simple words, like @command{reboot} or | 480 | Although 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. | |||
| 509 | Here is a more complicated @command{echo} example: | 508 | Here is a more complicated @command{echo} example: |
| 510 | 509 | ||
| 511 | @example | 510 | @example |
| 512 | echo A\ Multi-word\ Argument\ With\ A\ \$\ dollar | 511 | echo A\ Multi-word\ Argument\ With\ A\ \$\ dollar |
| 513 | @end example | 512 | @end example |
| 514 | 513 | ||
| 515 | Beyond this, things get a bit more complicated. While not beyond the | 514 | Beyond 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 | |||
| 794 | In that case, having an alias command name @command{glob} for | 793 | In 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 | |||
| 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 | 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 | ||
| 812 | It only really needs: to be hooked onto the output filter and the | 805 | 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. | 806 | pre-command hook, and to have the input-end and input-start markers. |
| 814 | And to know whether the last output group was ``successful''. | 807 | And 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 | ||