On 02/03/16 09:39, Jonas Ådahl wrote:
An xdg_tooltip is a new window type used to implement tooltip like
surfaces. See the interface documentation for details.

Signed-off-by: Jonas Ådahl <jad...@gmail.com>
---

Changes since v1:

Various wording changes as suggested by Mike.

Added missing version attribute and <description/>.


  unstable/xdg-shell/xdg-shell-unstable-v6.xml | 41 ++++++++++++++++++++++++++++
  1 file changed, 41 insertions(+)

diff --git a/unstable/xdg-shell/xdg-shell-unstable-v6.xml 
b/unstable/xdg-shell/xdg-shell-unstable-v6.xml
index f2eba64..a164bd6 100644
--- a/unstable/xdg-shell/xdg-shell-unstable-v6.xml
+++ b/unstable/xdg-shell/xdg-shell-unstable-v6.xml
@@ -168,6 +168,20 @@
        <arg name="y" type="int"/>
      </request>

+    <request name="get_tooltip">
+      <description summary="assign the xdg_tooltip surface role">
+       This creates an xdg_tooltip for the given xdg_surface and gives the
+       associated wl_surface the xdg_tooltip role.
+
+       See the documentation of xdg_tooltip for more details about what an
+       xdg_tooltip is and how it is used.
+      </description>
+      <arg name="id" type="new_id" interface="zxdg_tooltip_v6"/>
+      <arg name="parent" type="object" interface="zxdg_surface_v6"/>
+      <arg name="x" type="int"/>
+      <arg name="y" type="int"/>

Hi,

IMHO it'd be good describe the purpose of the coordinates, to avoid confusion and ensure that everybody use them in the same way.

Cheers,
Marek

+    </request>
+
      <request name="set_window_geometry">
        <description summary="set the new window geometry">
        The window geometry of a surface is its "visible bounds" from the
@@ -650,4 +664,31 @@

    </interface>

+  <interface name="zxdg_tooltip_v6" version="1">
+    <description summary="tooltip surface">
+      This interface defines an xdg_tooltip role that provides functionality
+      related to tooltip like surfaces.
+
+      An xdg_tooltip is a temporary surface which is displayed over its parent
+      xdg_surface. The last-created xdg_tooltip surface will always be the
+      top-most child of the parent xdg_surface.
+
+      The parent surface must either have the surface role xdg_toplevel,
+      xdg_popup or xdg_tooltip.
+
+      An xdg_tooltip does not take an active grab while mapped. xdg_tooltip
+      surfaces are either directly unmapped by clients using the
+      xdg_tooltip.destroy request or indirectly unmapped when their parent
+      surface is unmapped.
+
+      An xdg_tooltip obeys normal input region semantics.
+    </description>
+
+    <request name="destroy" type="destructor">
+      <description summary="destroy the xdg_tooltip object">
+       Unmap the tooltip surface and destroy the object.
+      </description>
+    </request>
+  </interface>
+
  </protocol>

_______________________________________________
wayland-devel mailing list
wayland-devel@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/wayland-devel

Reply via email to