diff options
author | Jonas Ådahl <jadahl@gmail.com> | 2017-10-30 17:24:23 +0800 |
---|---|---|
committer | Jonas Ådahl <jadahl@gmail.com> | 2017-11-21 16:25:51 +0800 |
commit | a82ca1f35b269a8f48a32fd09eb2a0f4954c57e4 (patch) | |
tree | 0f4728ccd756721f90422564ce14ac310d1c6837 | |
parent | 3c7dbb9646a3c05576d3cf69b265b4b8bfdb2dd3 (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>
-rw-r--r-- | stable/xdg-shell/xdg-shell.xml | 13 |
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 |