xwayland: document associate/dissociate events

This commit is contained in:
Simon Ser 2023-07-09 11:47:05 +02:00
parent 7a9f8d8d6b
commit 972c5f0c11

View file

@ -75,10 +75,9 @@ enum wlr_xwayland_icccm_input_model {
* An Xwayland user interface component. It has an absolute position in * An Xwayland user interface component. It has an absolute position in
* layout-local coordinates. * layout-local coordinates.
* *
* When a surface is ready to be displayed, the `map` event is emitted. When a * The inner struct wlr_surface is valid once the associate event is emitted.
* surface should no longer be displayed, the `unmap` event is emitted. The * Compositors can set up e.g. map and unmap listeners at this point. The
* `unmap` event is guaranteed to be emitted before the `destroy` event if the * struct wlr_surface becomes invalid when the dissociate event is emitted.
* view is destroyed when mapped.
*/ */
struct wlr_xwayland_surface { struct wlr_xwayland_surface {
xcb_window_t window_id; xcb_window_t window_id;