forked from extern/nushell
741d7b9f10
* Add `rm_always_trash` option to config * Add `--permanent` flag to `rm` * `rm`: error if both `-t` and `-p` are present Co-authored-by: Jonathan Turner <jonathandturner@users.noreply.github.com>
55 lines
2.7 KiB
Markdown
55 lines
2.7 KiB
Markdown
# config
|
|
|
|
Configuration management.
|
|
|
|
Syntax: `config {flags}`
|
|
|
|
### Flags
|
|
|
|
--load <file path shape>
|
|
load the config from the path give
|
|
|
|
--set <any shape>
|
|
set a value in the config, eg) --set [key value]
|
|
|
|
--set_into <member shape>
|
|
sets a variable from values in the pipeline
|
|
|
|
--get <any shape>
|
|
get a value from the config
|
|
|
|
--remove <any shape>
|
|
remove a value from the config
|
|
|
|
--clear
|
|
clear the config
|
|
|
|
--path
|
|
return the path to the config file
|
|
|
|
### Variables
|
|
|
|
| Variable | Type | Description |
|
|
| ------------------ | ---------------------- | ------------------------------------------------------------------------- |
|
|
| path | table of strings | PATH to use to find binaries |
|
|
| env | row | the environment variables to pass to external commands |
|
|
| ctrlc_exit | boolean | whether or not to exit Nu after multiple ctrl-c presses |
|
|
| table_mode | "light" or other | enable lightweight or normal tables |
|
|
| edit_mode | "vi" or "emacs" | changes line editing to "vi" or "emacs" mode |
|
|
| key_timeout | integer (milliseconds) | vi: the delay to wait for a longer key sequence after ESC |
|
|
| history_size | integer | maximum entries that will be stored in history (100,000 default) |
|
|
| completion_mode | "circular" or "list" | changes completion type to "circular" (default) or "list" mode |
|
|
| no_auto_pivot | boolean | whether or not to automatically pivot single-row results |
|
|
| complete_from_path | boolean | whether or not to complete names of binaries on PATH (default true) |
|
|
| rm_always_trash | boolean | whether or not to always use system trash when no flags are given to `rm` |
|
|
| pivot_mode | "auto" or "always" or "never" | "auto" will only pivot single row tables if the output is greater than the terminal width. "always" will always pivot single row tables. "never" will never pivot single row tables. |
|
|
| plugin_dirs | table of strings | additional directories to search for plugins during startup |
|
|
|
|
## Examples
|
|
|
|
```shell
|
|
> config --set [table_mode "light"]
|
|
```
|
|
|
|
A more detailed description on how to use this command to configure Nu shell can be found in the configuration chapter of [Nu Book](https://www.nushell.sh/book/en/configuration.html).
|