aboutsummaryrefslogtreecommitdiff
path: root/stable
diff options
context:
space:
mode:
authorJonas Ådahl <jadahl@gmail.com>2017-10-30 17:24:23 +0800
committerJonas Ådahl <jadahl@gmail.com>2017-11-21 16:25:51 +0800
commita82ca1f35b269a8f48a32fd09eb2a0f4954c57e4 (patch)
tree0f4728ccd756721f90422564ce14ac310d1c6837 /stable
parent3c7dbb9646a3c05576d3cf69b265b4b8bfdb2dd3 (diff)
xdg-shell: Clarify set_fullscreen semantics
It was not explicitly specified (as it is in set/unset_maximize) that the compositor will respond with a configure event when a client asks to be fullscreened, and the meaning of the output parameter was somewhat awkwardly described. Signed-off-by: Jonas Ådahl <jadahl@gmail.com> Reviewed-by: Mike Blumenkrantz <zmike@samsung.com>
Diffstat (limited to 'stable')
-rw-r--r--stable/xdg-shell/xdg-shell.xml13
1 files changed, 10 insertions, 3 deletions
diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml
index 6101413..8c7efab 100644
--- a/stable/xdg-shell/xdg-shell.xml
+++ b/stable/xdg-shell/xdg-shell.xml
@@ -886,9 +886,16 @@
<description summary="set the window as fullscreen on an output">
Make the surface fullscreen.
- You can specify an output that you would prefer to be fullscreen.
- If this value is NULL, it's up to the compositor to choose which
- display will be used to map this surface.
+ 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
+ also acknowledge the configure when committing the new content (see
+ ack_configure).
+
+ The output passed by the request indicates the client's preference as
+ to which display it should be set fullscreen on. If this value is NULL,
+ it's up to the compositor to choose which display will be used to map
+ this surface.
If the surface doesn't cover the whole output, the compositor will
position the surface in the center of the output and compensate with