summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--unstable/xdg-shell/xdg-shell-unstable-v6.xml31
1 files changed, 20 insertions, 11 deletions
diff --git a/unstable/xdg-shell/xdg-shell-unstable-v6.xml b/unstable/xdg-shell/xdg-shell-unstable-v6.xml
index 5e25e66..dfaf784 100644
--- a/unstable/xdg-shell/xdg-shell-unstable-v6.xml
+++ b/unstable/xdg-shell/xdg-shell-unstable-v6.xml
@@ -404,14 +404,17 @@
<request name="destroy" type="destructor">
<description summary="destroy the xdg_surface">
Destroy the xdg_surface object. An xdg_surface must only be destroyed
- after its role object has been destroyed.
+ after its role object has been destroyed. If the role object still
+ exists when this request is issued, the zxdg_shell_v6.defunct_surfaces
+ is raised.
</description>
</request>
<request name="get_toplevel">
<description summary="assign the xdg_toplevel surface role">
This creates an xdg_toplevel object for the given xdg_surface and gives
- the associated wl_surface the xdg_toplevel role.
+ the associated wl_surface the xdg_toplevel role. If the surface already
+ had a role, the zxdg_shell_v6.role error is raised.
See the documentation of xdg_toplevel for more details about what an
xdg_toplevel is and how it is used.
@@ -422,7 +425,8 @@
<request name="get_popup">
<description summary="assign the xdg_popup surface role">
This creates an xdg_popup object for the given xdg_surface and gives the
- associated wl_surface the xdg_popup role.
+ associated wl_surface the xdg_popup role. If the surface already
+ had a role, the zxdg_shell_v6.role error is raised.
See the documentation of xdg_popup for more details about what an
xdg_popup is and how it is used.
@@ -486,6 +490,9 @@
A client may send multiple ack_configure requests before committing, but
only the last request sent before a commit indicates which configure
event the client really is responding to.
+
+ If an invalid serial is used, the zxdg_shell_v6.invalid_surface_state
+ error is raised.
</description>
<arg name="serial" type="uint" summary="the serial from the configure event"/>
</request>
@@ -692,19 +699,21 @@
<entry name="maximized" value="1" summary="the surface is maximized">
<description summary="the surface is maximized">
The surface is maximized. The window geometry specified in the configure
- event must be obeyed by the client.
+ event must be obeyed by the client. If the window geometry is not obyed,
+ the zxdg_shell_v6.invalid_surface_state error is raised.
</description>
</entry>
<entry name="fullscreen" value="2" summary="the surface is fullscreen">
<description summary="the surface is fullscreen">
- The surface is fullscreen. The window geometry specified in the configure
- event must be obeyed by the client.
+ The surface is fullscreen. See set_fullscreen for more information.
</description>
</entry>
<entry name="resizing" value="3" summary="the surface is being resized">
<description summary="the surface is being resized">
The surface is being resized. The window geometry specified in the
- configure event is a maximum; the client cannot resize beyond it.
+ configure event is a maximum; the client cannot resize beyond it. If the
+ client attempts to resize above it, the zxdg_shell_v6.invalid_surface_state
+ error is raised.
Clients that have aspect ratio or cell sizing configuration can use
a smaller size, however.
</description>
@@ -752,8 +761,8 @@
a surface is illegal and will result in a protocol error.
The width and height must be greater than or equal to zero. Using
- strictly negative values for width and height will result in a
- protocol error.
+ strictly negative values for width and height will result in the
+ zxdg_shell_v6.invalid_surface_state error being raised.
</description>
<arg name="width" type="int"/>
<arg name="height" type="int"/>
@@ -793,8 +802,8 @@
a surface is illegal and will result in a protocol error.
The width and height must be greater than or equal to zero. Using
- strictly negative values for width and height will result in a
- protocol error.
+ strictly negative values for width and height will result in the
+ zxdg_shell_v6.invalid_surface_state error being raised.
</description>
<arg name="width" type="int"/>
<arg name="height" type="int"/>