aboutsummaryrefslogtreecommitdiff
path: root/stable
diff options
context:
space:
mode:
Diffstat (limited to 'stable')
-rw-r--r--stable/xdg-shell/xdg-shell.xml18
1 files changed, 14 insertions, 4 deletions
diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml
index 34e3a20..dc70c7a 100644
--- a/stable/xdg-shell/xdg-shell.xml
+++ b/stable/xdg-shell/xdg-shell.xml
@@ -728,8 +728,11 @@
</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. The window geometry specified in the
+ configure event is a maximum; the client cannot resize beyond it. For
+ a surface to cover the whole fullscreened area, the geometry
+ dimensions must be obeyed by the client. For more details, see
+ xdg_toplevel.set_fullscreen.
</description>
</entry>
<entry name="resizing" value="3" summary="the surface is being resized">
@@ -888,7 +891,7 @@
After requesting that the surface should be fullscreened, the
compositor will respond by emitting a configure event with the
- "fullscreen" state and the required window geometry. The client must
+ "fullscreen" state and the fullscreen window geometry. The client must
also acknowledge the configure when committing the new content (see
ack_configure).
@@ -899,7 +902,14 @@
If the surface doesn't cover the whole output, the compositor will
position the surface in the center of the output and compensate with
- black borders filling the rest of the output.
+ with border fill covering the rest of the output. The content of the
+ border fill is undefined, but should be assumed to be in some way that
+ attempts to blend into the surrounding area (e.g. solid black).
+
+ If the fullscreened surface is not opaque, the compositor must make
+ sure that other screen content not part of the same surface tree (made
+ up of subsurfaces, popups or similarly coupled surfaces) are not
+ visible below the fullscreened surface.
</description>
<arg name="output" type="object" interface="wl_output" allow-null="true"/>
</request>