From ffcf25cc2593c1b7acb93c85d4782c0fe4cc7082 Mon Sep 17 00:00:00 2001 From: Tudor Roman Date: Wed, 15 Apr 2020 15:04:40 +0000 Subject: [PATCH] seat: add selection event docs --- include/wlr/types/wlr_seat.h | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/include/wlr/types/wlr_seat.h b/include/wlr/types/wlr_seat.h index 4f1aa261..1b912875 100644 --- a/include/wlr/types/wlr_seat.h +++ b/include/wlr/types/wlr_seat.h @@ -251,11 +251,18 @@ struct wlr_seat { // wlr_seat_pointer_request_set_cursor_event struct wl_signal request_set_cursor; - // wlr_seat_request_set_selection_event - struct wl_signal request_set_selection; + // Called when an application _wants_ to set the selection (user copies some data). + // Compositors should listen to this event and call wlr_seat_set_selection + // if they want to accept the client's request. + struct wl_signal request_set_selection; // wlr_seat_request_set_selection_event + // Called after the data source is set for the selection. struct wl_signal set_selection; - // wlr_seat_request_set_primary_selection_event - struct wl_signal request_set_primary_selection; + + // Called when an application _wants_ to set the primary selection (user selects some data). + // Compositors should listen to this event and call wlr_seat_set_primary_selection + // if they want to accept the client's request. + struct wl_signal request_set_primary_selection; // wlr_seat_request_set_primary_selection_event + // Called after the primary selection source object is set. struct wl_signal set_primary_selection; // wlr_seat_request_start_drag_event