seat: add selection event docs
@@ -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
