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