1
1
mirror of https://github.com/wez/wezterm.git synced 2024-12-23 13:21:38 +03:00

docs: mention the CLI config overrides and per-window overrides

This commit is contained in:
Wez Furlong 2021-03-09 21:26:03 -08:00
parent 4c6780bb32
commit 354a12a0ff

View File

@ -28,6 +28,27 @@ that have side effects; for example, unconditionally launching background
processes can result in many of them being spawned over time if you launch
many copies of wezterm, or are frequently reloading your config file.
### Configuration Overrides
*since: nightly builds only*
`wezterm` allows overriding configuration values via the command line; here are
a couple of examples:
```bash
$ wezterm --config enable_scroll_bar=true
$ wezterm --config 'exit_behavior="Hold"'
```
Configuration specified via the command line will always override the values
provided by the configuration file, even if the configuration file is reloaded.
Each window can have an additional set of window-specific overrides applied to
it by code in your configuration file. That's useful for eg: setting
transparency or any other arbitrary option on a per-window basis. Read the
[window:set_config_overrides](lua/window/set_config_overrides.md) documentation
for more information and examples of how to use that functionality.
## Configuration File Structure
The `wezterm.lua` configuration file is a lua script which allows for a high