extern/nushell
1
0
Fork 1
mirror of https://github.com/nushell/nushell.git synced 2024-10-06 10:23:49 +02:00
Code Issues Packages Projects Releases Wiki Activity

Update alias docs to new syntax (#2917)

Browse Source 
This confused me today after upgrading Nu. I believe this is now correct.
This commit is contained in:
Louis Pilfold 2021-01-12 19:30:27 +00:00 committed by GitHub
parent dff85a7f70
commit dfb1e22559
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 6 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/commands/alias.md
View File

@ -2,13 +2,12 @@
This command allows you to define shortcuts for other common commands. By default, they only apply to the current session. To persist them, add `--save`. This command allows you to define shortcuts for other common commands. By default, they only apply to the current session. To persist them, add `--save`.
Syntax: `alias {flags} <name> [<parameters>] {<body>}` Syntax: `alias {flags} <name> = <body>`
The command expects three parameters: The command expects two parameters:
* The name of the alias * The name of the alias
* The parameters as a space-separated list (`[a b ...]`), can be empty (`[]`) * The body of the alias
* The body of the alias as a `{...}` block
## Flags ## Flags
@ -19,31 +18,18 @@ The command expects three parameters:
Define a custom `myecho` command as an alias: Define a custom `myecho` command as an alias:
```shell ```shell
> alias myecho [msg] { echo $msg } > alias myecho = echo
> myecho "hello world" > myecho "hello world"
hello world hello world
``` ```
Since the parameters are well defined, calling the command with the wrong number of parameters will fail properly:
```shell
> myecho hello world
error: myecho unexpected world
- shell:1:18
1 | myecho hello world
| ^^^^^ unexpected argument (try myecho -h)
```
The suggested help command works! The suggested help command works!
```shell ```shell
> myecho -h > myecho -h
Usage: Usage:
> myecho ($msg) {flags} > myecho {flags}
parameters:
($msg)
flags: flags:
-h, --help: Display this help message -h, --help: Display this help message
@ -54,7 +40,7 @@ flags:
Aliases are most useful when they are persistent. For that, use the `--save` flag: Aliases are most useful when they are persistent. For that, use the `--save` flag:
```shell ```shell
> alias --save myecho [msg] { echo $msg } > alias --save myecho = echo
``` ```
This will store the alias in your config, under the `startup` key. To edit the saved alias, run it again with the same name, or edit your config file directly. You can find the location of the file using `config path`. This will store the alias in your config, under the `startup` key. To edit the saved alias, run it again with the same name, or edit your config file directly. You can find the location of the file using `config path`.