diff --git a/staging/xdg-activation/xdg-activation-v1.xml b/staging/xdg-activation/xdg-activation-v1.xml index 9adcc27..c8985e9 100644 --- a/staging/xdg-activation/xdg-activation-v1.xml +++ b/staging/xdg-activation/xdg-activation-v1.xml @@ -66,7 +66,7 @@ only be done by creating a new major version of the extension. - + A global interface used for informing the compositor about applications being activated or started, or for applications to request to be @@ -110,9 +110,14 @@ + + + + + - + An object for setting up a token and receiving a token handle that can be passed as an activation token to another client. @@ -197,4 +202,67 @@ + + + + Some clients allow having multiple documents in a single window, while + also allowing multiple windows at the same time. When such a client + is asked to open a new document by another application, it needs to + choose a window to open it in, but it doesn't have enough contextual + information to do that well in all cases. It can for example not know if + a window is currently on an inactive virtual desktop. + + This interface allows the client to make the compositor choose a window + to open a new document in. To do this, the client must provide the + possible choices with add_window_candidate_surface and + add_window_candidate_handle, optionally provide an activation token, and + afterwards commit. + + + + + If the application sets an activation token, the compositor might use + it to improve its choice, for example by ensuring the chosen candidate + is on the same virtual desktop as the surface requesting the activation. + + + + + + + Adds a candidate in the form of a window handle exported with + xdg_foreign_unstable_v2. + + + + + + + When the compositor processes this request, it must immediately + either send chosen_candidate or new_candidate_preferred, and afterwards + destroy this object. + + + + + + The compositor sends this event if the client should use an existing + window. + + + + + + + The compositor sends this event if it deems none of the candidates a + suitable choice for the client. Instead, the client should create a + new window to open the document in. + + In order to allow multi-window multi-instance applications to choose + which instance should create the new window, the compositor may send + a handle of its next best choice for window activation. + + + +