[PATCH weston 12/17] xdg-shell: Some minor clarifications
jadahl at gmail.com
Tue Apr 7 02:01:27 PDT 2015
Mention set_window_geometry in configure documentation.
Add a strategic "For instance" to clarify what is just an example.
Clarify that the arguments of set_window_geometry are in the surface
local coordinate space.
Point out that the client needs to destroy a dismissed popup.
Signed-off-by: Jonas Ådahl <jadahl at gmail.com>
protocol/xdg-shell.xml | 16 ++++++++++------
1 file changed, 10 insertions(+), 6 deletions(-)
diff --git a/protocol/xdg-shell.xml b/protocol/xdg-shell.xml
index ef16b73..6d02510 100644
@@ -362,7 +362,7 @@
The width and height arguments specify a hint to the window
about how its surface should be resized in window geometry
+ coordinates. See set_window_geometry.
The states listed in the event specify how the width/height
arguments should be interpreted, and possibly how it should be
@@ -391,9 +391,9 @@
must make a ack_configure request before the commit request,
passing along the serial of the configure event.
- The compositor might use this information to move a surface
- to the top left only when the client has drawn itself for
- the maximized or fullscreen state.
+ For instance, the compositor might use this information to move
+ a surface to the top left only when the client has drawn itself
+ for the maximized or fullscreen state.
If the client receives multiple configure events before it
can respond to one, it only has to ack the last configure event.
@@ -424,6 +424,9 @@
must respect the sizing negotiations specified by the states in
the configure event.
+ The arguments are given in the surface local coordinate space of
+ the wl_surface associated with this xdg_surface.
The width and height must be greater than zero.
<arg name="x" type="int"/>
@@ -536,8 +539,9 @@
<description summary="popup interaction is done">
- The popup_done event is sent out when a popup is dismissed
- by the compositor.
+ The popup_done event is sent out when a popup is dismissed by the
+ compositor. The client should destroy the xdg_popup object at this
More information about the wayland-devel