On Tue, Apr 07, 2015 at 05:01:27PM +0800, Jonas Ådahl wrote: > 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 <[email protected]> Reviewed-by: Bryce Harrington <[email protected]>
> --- > 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 > --- a/protocol/xdg-shell.xml > +++ b/protocol/xdg-shell.xml > @@ -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. > + 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. > </description> > <arg name="x" type="int"/> > @@ -536,8 +539,9 @@ > > <event name="popup_done"> > <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 > + point. > </description> > </event> > > -- > 2.1.4 > > _______________________________________________ > wayland-devel mailing list > [email protected] > http://lists.freedesktop.org/mailman/listinfo/wayland-devel _______________________________________________ wayland-devel mailing list [email protected] http://lists.freedesktop.org/mailman/listinfo/wayland-devel
