From 41488b0fdb70d9a676ac1f2bae0627d1e443487d Mon Sep 17 00:00:00 2001 From: Michael Weiser Date: Sat, 25 Jan 2020 23:56:07 +0100 Subject: [PATCH] sway: Update manpage for pointer gestures Add description of pointer gesture binding configuration and behaviour to the sway(5) manual page. Signed-off-by: Michael Weiser --- sway/sway.5.scd | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/sway/sway.5.scd b/sway/sway.5.scd index 8958c7e30..db856075e 100644 --- a/sway/sway.5.scd +++ b/sway/sway.5.scd @@ -440,6 +440,17 @@ runtime. is over an empty workspace. Using a mouse binding over a layer surface's exclusive region is not currently possible. + Special events _SWIPE\_{3,4}\_{UP,DOWN,LEFT,RIGHT}_ respond to three- and + four-finger swipe gestures respectively. The binding to execute is + selected based on the number of fingers used and ultimate overall + direction of the gesture. Because the latter cannot be determined + before the gesture has actually finished, bindings are only ever + executed on release. Therefore bindings with flag _--release_ are + ignored if there is an on-press binding as well because they would be + executed at the same time anyway. Gestures executed while the pointer + is above a bar are not handled by sway. See the respective + documentation, e.g. *bindsym* in *sway-bar*(5). + Example: ``` # Execute firefox when alt, shift, and f are pressed together