diff --git a/staging/ext-toplevel-placement/ext-toplevel-placement-v1.xml b/staging/ext-toplevel-placement/ext-toplevel-placement-v1.xml index 508b8a3..00adb1a 100644 --- a/staging/ext-toplevel-placement/ext-toplevel-placement-v1.xml +++ b/staging/ext-toplevel-placement/ext-toplevel-placement-v1.xml @@ -92,8 +92,9 @@ Compositors are unlikely to substantially alter placement based on suggestions sent after the window is already mapped and positioned. - This request causes the compositor to send the placement state, including - the output and logical coordinates where the toplevel is currently placed. + This request causes the compositor to send `placement_state`, including + the output and logical coordinates where the toplevel is currently placed, + or `not_placed`. @@ -127,6 +128,18 @@ + + + This event is sent if the compositor *cannot* place the toplevel window + *as suggested*. This might be due to various reasons like no suitable output, + geometry conflicts, or unresolvable policy restrictions *after considering the suggestion*. + Receiving this event implies that the compositor will *not* honor the + placement suggestion and the toplevel might not be placed at all, or will be + placed using a fallback mechanism unrelated to the suggestion. + + + + \ No newline at end of file