seat: add selection event docs

1 files 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