wez/wezterm
1
1
Fork 0
mirror of https://github.com/wez/wezterm.git synced 2024-11-23 06:54:45 +03:00
Code Issues Projects Releases Wiki Activity

Extract doc of treat_left_ctrlalt_as_altgr and leave a reference

Browse Source
This commit is contained in:
Benoit de Chezelles 2021-03-07 20:21:29 +01:00 committed by Wez Furlong
parent 683d8e96e8
commit abcc73fd22
2 changed files with 18 additions and 14 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/config/keys.md
View File

@ -102,20 +102,7 @@ return {
### Microsoft Windows and Ctrl-Alt <-> AltGr
*since: nightly*
If you are using a layout with an *AltGr* key, you may experience issues
when running inside a VNC session, because VNC emulates the AltGr keypresses
by sending plain *Ctrl-Alt* keys, which won't be understood as AltGr.
To fix this behavior you can tell WezTerm to treat left *Ctrl-Alt* keys as
*AltGr* with the option `treat_left_ctrlalt_as_altgr`. Note that the key bindings using separate Ctrl and Alt won't be triggered anymore.
```lua
return {
treat_left_ctrlalt_as_altgr = true
}
```
If you are using VNC and a keyboard layout with dead keys, then you may wish to enable [treat_left_ctrlalt_as_altgr](lua/config/treat_left_ctrlalt_as_altgr.md).
### Defining Assignments for key combinations that may be composed

17
docs/config/lua/config/treat_left_ctrlalt_as_altgr.md Normal file
View File

@ -0,0 +1,17 @@
# `treat_left_ctrlalt_as_altgr = false`
*since: nightly*
If you are using a layout with an *AltGr* key, you may experience issues
when running inside a VNC session, because VNC emulates the AltGr keypresses
by sending plain *Ctrl-Alt* keys, which won't be understood as AltGr.
To fix this behavior you can tell WezTerm to treat left *Ctrl-Alt* keys as
*AltGr* with the option `treat_left_ctrlalt_as_altgr`. Note that the key
bindings using separate Ctrl and Alt won't be triggered anymore.
```lua
return {
treat_left_ctrlalt_as_altgr = true
}
```