From 972c5f0c11738a9686f566ffc1ae3b2b96c28abd Mon Sep 17 00:00:00 2001 From: Simon Ser Date: Sun, 9 Jul 2023 11:47:05 +0200 Subject: xwayland: document associate/dissociate events --- include/wlr/xwayland/xwayland.h | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/include/wlr/xwayland/xwayland.h b/include/wlr/xwayland/xwayland.h index 944d3907..0f7d232a 100644 --- a/include/wlr/xwayland/xwayland.h +++ b/include/wlr/xwayland/xwayland.h @@ -75,10 +75,9 @@ enum wlr_xwayland_icccm_input_model { * An Xwayland user interface component. It has an absolute position in * layout-local coordinates. * - * When a surface is ready to be displayed, the `map` event is emitted. When a - * surface should no longer be displayed, the `unmap` event is emitted. The - * `unmap` event is guaranteed to be emitted before the `destroy` event if the - * view is destroyed when mapped. + * The inner struct wlr_surface is valid once the associate event is emitted. + * Compositors can set up e.g. map and unmap listeners at this point. The + * struct wlr_surface becomes invalid when the dissociate event is emitted. */ struct wlr_xwayland_surface { xcb_window_t window_id; -- cgit v1.2.3