diff options
| author | Michael Albinus | 2017-10-01 13:31:39 +0200 |
|---|---|---|
| committer | Michael Albinus | 2017-10-01 13:31:39 +0200 |
| commit | 1ba3471b9b443f0617662f4a50439bec211162ba (patch) | |
| tree | 244aa5b171c4796e850d3ab1bfa8ddcc9d2772a8 | |
| parent | 7abb5c39601a420bf74db41e2d70f8e36d07e349 (diff) | |
| download | emacs-1ba3471b9b443f0617662f4a50439bec211162ba.tar.gz emacs-1ba3471b9b443f0617662f4a50439bec211162ba.zip | |
eshell.texi improvements
* doc/misc/eshell.texi (Built-ins): eshell/sudo is a compiled
Lisp function in `em-tramp.el'. Mention also $*, $1, $2, ...
(Aliases): Add $*, $1, $2, ... to the variable index.
| -rw-r--r-- | doc/misc/eshell.texi | 8 |
1 files changed, 6 insertions, 2 deletions
diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi index 8a607ef7702..73f9a9562b1 100644 --- a/doc/misc/eshell.texi +++ b/doc/misc/eshell.texi | |||
| @@ -239,7 +239,6 @@ especially for file names with special characters like pipe | |||
| 239 | (@code{|}), which could be part of remote file names. | 239 | (@code{|}), which could be part of remote file names. |
| 240 | 240 | ||
| 241 | @node Built-ins | 241 | @node Built-ins |
| 242 | |||
| 243 | @section Built-in commands | 242 | @section Built-in commands |
| 244 | Several commands are built-in in Eshell. In order to call the | 243 | Several commands are built-in in Eshell. In order to call the |
| 245 | external variant of a built-in command @code{foo}, you could call | 244 | external variant of a built-in command @code{foo}, you could call |
| @@ -258,7 +257,7 @@ alias, @ref{Aliases}. Example: | |||
| 258 | 257 | ||
| 259 | @example | 258 | @example |
| 260 | ~ $ which sudo | 259 | ~ $ which sudo |
| 261 | eshell/sudo is a compiled Lisp function in `em-unix.el' | 260 | eshell/sudo is a compiled Lisp function in `em-tramp.el'. |
| 262 | ~ $ alias sudo '*sudo $*' | 261 | ~ $ alias sudo '*sudo $*' |
| 263 | ~ $ which sudo | 262 | ~ $ which sudo |
| 264 | sudo is an alias, defined as "*sudo $*" | 263 | sudo is an alias, defined as "*sudo $*" |
| @@ -419,6 +418,9 @@ Lisp functions, based on successful completion). | |||
| 419 | 418 | ||
| 420 | @end table | 419 | @end table |
| 421 | 420 | ||
| 421 | @ref{Aliases} for the built-in variables @samp{$*}, @samp{$1}, | ||
| 422 | @samp{$2}, @dots{}, in alias definitions. | ||
| 423 | |||
| 422 | @node Variables | 424 | @node Variables |
| 423 | @section Variables | 425 | @section Variables |
| 424 | Since Eshell is just an Emacs REPL@footnote{Read-Eval-Print Loop}, it | 426 | Since Eshell is just an Emacs REPL@footnote{Read-Eval-Print Loop}, it |
| @@ -429,6 +431,7 @@ would in an Elisp program. Eshell provides a command version of | |||
| 429 | @node Aliases | 431 | @node Aliases |
| 430 | @section Aliases | 432 | @section Aliases |
| 431 | 433 | ||
| 434 | @vindex $* | ||
| 432 | Aliases are commands that expand to a longer input line. For example, | 435 | Aliases are commands that expand to a longer input line. For example, |
| 433 | @command{ll} is a common alias for @code{ls -l}, and would be defined | 436 | @command{ll} is a common alias for @code{ls -l}, and would be defined |
| 434 | with the command invocation @kbd{alias ll 'ls -l $*'}; with this defined, | 437 | with the command invocation @kbd{alias ll 'ls -l $*'}; with this defined, |
| @@ -438,6 +441,7 @@ automatically written to the file named by @code{eshell-aliases-file}, | |||
| 438 | which you can also edit directly (although you will have to manually | 441 | which you can also edit directly (although you will have to manually |
| 439 | reload it). | 442 | reload it). |
| 440 | 443 | ||
| 444 | @vindex $1, $2, @dots{} | ||
| 441 | Note that unlike aliases in Bash, arguments must be handled | 445 | Note that unlike aliases in Bash, arguments must be handled |
| 442 | explicitly. Typically the alias definition would end in @samp{$*} to | 446 | explicitly. Typically the alias definition would end in @samp{$*} to |
| 443 | pass all arguments along. More selective use of arguments via | 447 | pass all arguments along. More selective use of arguments via |