Update protocol for xdg-output-unstable-v1

Change-Id: I7d7a2fdbd1f44469b90c467c9490448c13025fa5
Reviewed-by: Pier Luigi Fiorini <pierluigi.fiorini@liri.io>
This commit is contained in:
Johan Klokkhammer Helsing 2020-01-09 10:08:23 +01:00
parent 850506e125
commit 174a93750a
2 changed files with 18 additions and 7 deletions

View File

@ -150,8 +150,8 @@ Copyright 2015-2016 © Red Hat, Inc."
"Description": "The XDG Output protocol is an extended way to describe output regions under Wayland", "Description": "The XDG Output protocol is an extended way to describe output regions under Wayland",
"Homepage": "https://wayland.freedesktop.org", "Homepage": "https://wayland.freedesktop.org",
"Version": "unstable v1, version 2", "Version": "unstable v1, version 3",
"DownloadLocation": "https://gitlab.freedesktop.org/wayland/wayland-protocols/raw/1.17/unstable/xdg-output/xdg-output-unstable-v1.xml", "DownloadLocation": "https://gitlab.freedesktop.org/wayland/wayland-protocols/raw/1.18/unstable/xdg-output/xdg-output-unstable-v1.xml",
"LicenseId": "MIT", "LicenseId": "MIT",
"License": "MIT License", "License": "MIT License",
"LicenseFile": "MIT_LICENSE.txt", "LicenseFile": "MIT_LICENSE.txt",

View File

@ -54,7 +54,7 @@
reset. reset.
</description> </description>
<interface name="zxdg_output_manager_v1" version="2"> <interface name="zxdg_output_manager_v1" version="3">
<description summary="manage xdg_output objects"> <description summary="manage xdg_output objects">
A global factory interface for xdg_output objects. A global factory interface for xdg_output objects.
</description> </description>
@ -77,12 +77,17 @@
</request> </request>
</interface> </interface>
<interface name="zxdg_output_v1" version="2"> <interface name="zxdg_output_v1" version="3">
<description summary="compositor logical output region"> <description summary="compositor logical output region">
An xdg_output describes part of the compositor geometry. An xdg_output describes part of the compositor geometry.
This typically corresponds to a monitor that displays part of the This typically corresponds to a monitor that displays part of the
compositor space. compositor space.
For objects version 3 onwards, after all xdg_output properties have been
sent (when the object is created and when properties are updated), a
wl_output.done event is sent. This allows changes to the output
properties to be seen as atomic, even if they happen via multiple events.
</description> </description>
<request name="destroy" type="destructor"> <request name="destroy" type="destructor">
@ -157,6 +162,10 @@
This allows changes to the xdg_output properties to be seen as This allows changes to the xdg_output properties to be seen as
atomic, even if they happen via multiple events. atomic, even if they happen via multiple events.
For objects version 3 onwards, this event is deprecated. Compositors
are not required to send it anymore and must send wl_output.done
instead.
</description> </description>
</event> </event>
@ -197,10 +206,12 @@
output via :1'. output via :1'.
The description event is sent after creating an xdg_output (see The description event is sent after creating an xdg_output (see
xdg_output_manager.get_xdg_output). This event is only sent once per xdg_output_manager.get_xdg_output) and whenever the description
changes. The description is optional, and may not be sent at all.
For objects of version 2 and lower, this event is only sent once per
xdg_output, and the description does not change over the lifetime of xdg_output, and the description does not change over the lifetime of
the wl_output global. The description is optional, and may not be sent the wl_output global.
at all.
</description> </description>
<arg name="description" type="string" summary="output description"/> <arg name="description" type="string" summary="output description"/>
</event> </event>