forked from mirrors/prezto
1ff9421f7b
Zsh and Prezto files don't always reside in `~/`. Instead, they have
a more spec compliant location (`${ZDOTDIR:-$HOME}/`). Make them
unambiguous in the documentation. Likewise, for `$GNUPGHOME`.
Further, add instruction for optionally setting up Prezto in
`$XDG_CONFIG_HOME`.
While at this, also add clarification on relative ordering of some of
the modules, apply more formatting tweaks and doc improvements.
55 lines
1.5 KiB
Markdown
55 lines
1.5 KiB
Markdown
# Terminal
|
|
|
|
Sets terminal window and tab titles.
|
|
|
|
## Settings
|
|
|
|
### Auto-Title
|
|
|
|
To auto set the terminal window and tab titles with the current command or
|
|
directory, add the following to _`${ZDOTDIR:-$HOME}/.zpreztorc`_:
|
|
|
|
```sh
|
|
zstyle ':prezto:module:terminal' auto-title 'yes'
|
|
```
|
|
|
|
Auto titling is disabled inside terminal multiplexers (except inside dvtm) since
|
|
it interferes with window names defined in configuration files and profile
|
|
managers. This can be overridden by setting it to `always`.
|
|
|
|
```sh
|
|
zstyle ':prezto:module:terminal' auto-title 'always'
|
|
```
|
|
|
|
### Title formats
|
|
|
|
To format terminal window and tab titles, add the following to
|
|
_`${ZDOTDIR:-$HOME}/.zpreztorc`_.
|
|
|
|
```sh
|
|
zstyle ':prezto:module:terminal:window-title' format '%n@%m: %s'
|
|
zstyle ':prezto:module:terminal:tab-title' format '%m: %s'
|
|
zstyle ':prezto:module:terminal:multiplexer-title' format '%s'
|
|
```
|
|
|
|
`%s` will be replaced with the current working directory path or the currently
|
|
executing program name.
|
|
|
|
For a list of sequences, see [Expansion of Prompt Sequences][1].
|
|
|
|
## Functions
|
|
|
|
- `set-tab-title` sets the terminal tab title.
|
|
- `set-window-title` sets the terminal window title.
|
|
- `set-multiplexer-title` sets the terminal multiplexer title.
|
|
|
|
## Authors
|
|
|
|
_The authors of this module should be contacted via the [issue tracker][2]._
|
|
|
|
- [Sorin Ionescu](https://github.com/sorin-ionescu)
|
|
- [Olaf Conradi](https://github.com/oohlaf)
|
|
|
|
[1]: https://zsh.sourceforge.net/Doc/Release/Prompt-Expansion.html#Expansion-of-Prompt-Sequences
|
|
[2]: https://github.com/sorin-ionescu/prezto/issues
|