From: Kristian Høgsberg <krh@bitplanet.net>
Date: Thu, 9 Dec 2010 16:06:46 +0000 (-0500)
Subject: Document the shell.configure event a bit
X-Git-Tag: 0.85.0~319
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=67f367f329f3640d12db43cf5dc14e7f8b1e1242;p=platform%2Fupstream%2Fwayland.git

Document the shell.configure event a bit
---

diff --git a/protocol/wayland.xml b/protocol/wayland.xml
index ca887a9..62d8a66 100644
--- a/protocol/wayland.xml
+++ b/protocol/wayland.xml
@@ -164,6 +164,12 @@
       <arg name="id" type="new_id" interface="drag"/>
     </request>
 
+    <!-- The configure event asks the client to resize its surface.
+         The size is a hint, in the sense that the client is free to
+         ignore it if it doesn't resize, pick a smaller size (to
+         satisfy aspect ration or resize in steps of NxM pixels).  The
+         client is free to dismiss all but the last configure event it
+         received. -->
     <event name="configure">
       <arg name="time" type="uint"/>
       <!-- Same as edges except also move (16) -->