summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/guide.md6
1 files changed, 5 insertions, 1 deletions
diff --git a/docs/guide.md b/docs/guide.md
index 7f02ab7..2926011 100644
--- a/docs/guide.md
+++ b/docs/guide.md
@@ -222,7 +222,11 @@ with `device` distinguishing mouse, touch, pen, and eraser. `POINTER_DOWN` and
or touch contact. Other types leave `button` meaningless. Every pointer event
also carries `buttons`, a `YASL_BUTTON_BIT()` mask of the buttons held after
that event, tracked from the queue's down and up events. Use it to tell a drag
-from a hover. `YASL_EVENT_INPUT_RESET` clears the mask. On Wayland,
+from a hover. Count clicks against `yasl_display_double_click_ms()`, the
+system interval: XSETTINGS on X11, the KDE or GNOME setting through the
+Settings portal on Wayland, and the system value on Cocoa. It falls back to
+`YASL_DOUBLE_CLICK_MS_DEFAULT` (400 ms). The query can wait briefly on Linux, so
+read it when a window gains focus. `YASL_EVENT_INPUT_RESET` clears the mask. On Wayland,
`POINTER_LEAVE` also clears it, because the compositor sends leave during a
press only when it takes the pointer away. X11 and Cocoa keep the press across
leave and still deliver the release. `POINTER_MOTION` reports `delta`, the device-pixel movement since