aboutsummaryrefslogtreecommitdiff
path: root/extra
diff options
context:
space:
mode:
authorKirill Chibisov <contact@kchibisov.com>2023-07-11 02:22:14 +0000
committerGitHub <noreply@github.com>2023-07-11 02:22:14 +0000
commitdb903503df024a3f5066937fbe0272be88226738 (patch)
tree67dcf4a2ae5d8dd75a08d21b3a4a6947b23ff720 /extra
parent09c4471b4cd6b32a2de79a08c447284b62a80d54 (diff)
downloadalacritty-db903503df024a3f5066937fbe0272be88226738.tar.gz
alacritty-db903503df024a3f5066937fbe0272be88226738.zip
Update to the new winit keyboard API
The main highlight of this update is that alacritty will now use new keyboard API from the winit, which resolves a lot of issues around key bindings, such as ability to bind dead keys. It also fixes long standing issues with the virtual key code bindings and make bindings in general more predictable. It also makes our default Vi key bindings fully working. Given that alacritty was using `VirtualKey` directly in the bindings from the winit, and winit simply removed the enum, we've added internal conversions to minimize the fallout, but new way to specify the bindings should be more intuitive. Other part of this update fixes some forward compatibility bugs with the Wayland backend, given that wayland-rs 0.30 is fully forward compatible. The update also fixes weird Maximized startup issues on GNOME Wayland, however they were present on any sane compositor. Fixes #6842. Fixes #6455. Fixes #6184. Fixes #5684. Fixes #3574. Fixes #3460. Fixes #1336. Fixes #892. Fixes #458. Fixes #55.
Diffstat (limited to 'extra')
-rw-r--r--extra/man/alacritty-bindings.5.scd48
-rw-r--r--extra/man/alacritty.5.scd13
2 files changed, 32 insertions, 29 deletions
diff --git a/extra/man/alacritty-bindings.5.scd b/extra/man/alacritty-bindings.5.scd
index 988c1505..ddd4a6ea 100644
--- a/extra/man/alacritty-bindings.5.scd
+++ b/extra/man/alacritty-bindings.5.scd
@@ -153,7 +153,7 @@ configuration. See *alacritty*(5) for full configuration format documentation.
: _"Alt"_
: _"Vi|~Search"_
: _"ToggleSemanticSelection"_
-| _"Return"_
+| _"Enter"_
:[
: _"Vi|~Search"_
: _"Open"_
@@ -177,31 +177,31 @@ configuration. See *alacritty*(5) for full configuration format documentation.
:[
: _"Vi|~Search"_
: _"Right"_
-| _"Up"_
+| _"ArrowUp"_
:[
: _"Vi|~Search"_
: _"Up"_
-| _"Down"_
+| _"ArrowDown"_
:[
: _"Vi|~Search"_
: _"Down"_
-| _"Left"_
+| _"ArrowLeft"_
:[
: _"Vi|~Search"_
: _"Left"_
-| _"Right"_
+| _"ArrowRight"_
:[
: _"Vi|~Search"_
: _"Right"_
-| _"Key0"_
+| _"0"_
:[
: _"Vi|~Search"_
: _"First"_
-| _"Key4"_
+| _"4"_
: _"Shift"_
: _"Vi|~Search"_
: _"Last"_
-| _"Key6"_
+| _"6"_
: _"Shift"_
: _"Vi|~Search"_
: _"FirstOccupied"_
@@ -241,15 +241,15 @@ configuration. See *alacritty*(5) for full configuration format documentation.
: _"Shift"_
: _"Vi|~Search"_
: _"WordRightEnd"_
-| _"Key5"_
+| _"5"_
: _"Shift"_
: _"Vi|~Search"_
: _"Bracket"_
-| _"Slash"_
+| _"/"_
:[
: _"Vi|~Search"_
: _"SearchForward"_
-| _"Slash"_
+| _"/"_
: _"Shift"_
: _"Vi|~Search"_
: _"SearchBackward"_
@@ -269,7 +269,7 @@ configuration. See *alacritty*(5) for full configuration format documentation.
:[ *mods*
:[ *mode*
:[ *action*
-| _"Return"_
+| _"Enter"_
:[
: _"Search|Vi"_
: _"SearchConfirm"_
@@ -297,15 +297,15 @@ configuration. See *alacritty*(5) for full configuration format documentation.
: _"Control"_
: _"Search"_
: _"SearchHistoryNext"_
-| _"Up"_
+| _"ArrowUp"_
:[
: _"Search"_
: _"SearchHistoryPrevious"_
-| _"Down"_
+| _"ArrowDown"_
:[
: _"Search"_
: _"SearchHistoryNext"_
-| _"Return"_
+| _"Enter"_
:[
: _"Search|~Vi"_
: _"SearchFocusNext"_
@@ -340,15 +340,15 @@ configuration. See *alacritty*(5) for full configuration format documentation.
: _"Shift"_
:[
: _"PasteSelection"_
-| _"Key0"_
+| _"0"_
: _"Control"_
:[
: _"ResetFontSize"_
-| _"Equals"_
+| _"="_
: _"Control"_
:[
: _"IncreaseFontSize"_
-| _"Plus"_
+| _"+"_
: _"Control"_
:[
: _"IncreaseFontSize"_
@@ -356,7 +356,7 @@ configuration. See *alacritty*(5) for full configuration format documentation.
: _"Control"_
:[
: _"IncreaseFontSize"_
-| _"Minus"_
+| _"-"_
: _"Control"_
:[
: _"DecreaseFontSize"_
@@ -371,7 +371,7 @@ configuration. See *alacritty*(5) for full configuration format documentation.
:[ *mods*
:[ *mode*
:[ *action*
-| _"Return"_
+| _"Enter"_
: _"Alt"_
:[
: _"ToggleFullscreen"_
@@ -390,15 +390,15 @@ configuration. See *alacritty*(5) for full configuration format documentation.
: _"Command"_
: _"~Vi|~Search"_
: _"ClearHistory"_
-| _"Key0"_
+| _"0"_
: _"Command"_
:[
: _"ResetFontSize"_
-| _"Equals"_
+| _"="_
: _"Command"_
:[
: _"IncreaseFontSize"_
-| _"Plus"_
+| _"+"_
: _"Command"_
:[
: _"IncreaseFontSize"_
@@ -406,7 +406,7 @@ configuration. See *alacritty*(5) for full configuration format documentation.
: _"Command"_
:[
: _"IncreaseFontSize"_
-| _"Minus"_
+| _"-"_
: _"Command"_
:[
: _"DecreaseFontSize"_
diff --git a/extra/man/alacritty.5.scd b/extra/man/alacritty.5.scd
index 78884e32..f0124dbe 100644
--- a/extra/man/alacritty.5.scd
+++ b/extra/man/alacritty.5.scd
@@ -656,11 +656,14 @@ This section documents the *[keyboard]* table of the configuration file.
*key* <string>
- Identifier of the binding's key, for example: _"A"_, _"F1"_, or
- _"Key0"_.
-
- A full list with available key codes can be found here:++
-https://docs.rs/winit/\*/winit/event/enum.VirtualKeyCode.html#variants
+ The regular keys like _"A"_, _"0"_, and _"Я"_ can be mapped directly
+ without any special syntax. Full list of named keys like _"F1"_ and the
+ syntax for dead keys can be found here:++
+https://docs.rs/winit/\*/winit/keyboard/enum.Key.html
+
+ Numpad keys are prefixed by _Numpad_: "NumpadEnter" | "NumpadAdd" |
+ "NumpadComma" | "NumpadDivide" | "NumpadEquals" | "NumpadSubtract" |
+ "NumpadMultiply" | "Numpad[0-9]".
The _key_ field also supports using scancodes, which are specified as a
decimal number.