From a82ca1f35b269a8f48a32fd09eb2a0f4954c57e4 Mon Sep 17 00:00:00 2001 From: Jonas Ådahl Date: Mon, 30 Oct 2017 17:24:23 +0800 Subject: xdg-shell: Clarify set_fullscreen semantics MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 Reviewed-by: Mike Blumenkrantz --- stable/xdg-shell/xdg-shell.xml | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) (limited to 'stable') 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 @@ 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 -- cgit v1.2.3