xdg-shell: Document that xdg_surface.set_window_geometry needs a commit

Signed-off-by: Jonas Ådahl <jadahl@gmail.com>
Reviewed-by: Bryce Harrington <bryce@osg.samsung.com>
Reviewed-by: Pekka Paalanen <pekka.paalanen@collabora.co.uk>

diff --git a/protocol/xdg-shell.xml b/protocol/xdg-shell.xml
index 79e30a0..deadf51 100644 (file)
--- a/protocol/xdg-shell.xml
+++ b/protocol/xdg-shell.xml
@@ -362,6 +362,9 @@
         portions like drop-shadows which should be ignored for the
         purposes of aligning, placing and constraining windows.
 
+        The window geometry is double buffered, and will be applied at the
+        time wl_surface.commit of the corresponding wl_surface is called.
+
         Once the window geometry of the surface is set once, it is not
         possible to unset it, and it will remain the same until
         set_window_geometry is called again, even if a new subsurface or