<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Jan 12, 2016 at 12:16 AM, Jonas Ådahl <span dir="ltr"><<a href="mailto:jadahl@gmail.com" target="_blank">jadahl@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">An xdg_tooltip is a new window type used to implement tooltip like<br>
surfaces. See the interface documentation for details.<br>
<br>
+    <request name="get_tooltip"><br>
+      <description summary="assign the xdg_tooltip surface role"><br>
+       This creates an xdg_tooltip for the given xdg_surface and gives the<br>
+       associated wl_surface the xdg_tooltip role. >>>A wl_surface can only have<br>
+       one xdg_tooltip role. If the wl_surface is given the xdg_tooltip role<br>
+       while it already has an active xdg_tooltip role, or if it has been given<br>
+       any other role before, an error is raised.<<<<br></blockquote><div><br></div><div>I believe all the text between >>> and <<< is redundant, it has already been established that you can set the role of a surface exactly once.<br> <br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
+       See the documentation of xdg_tooltip for more details about what an<br>
+       xdg_tooltip is and how it is used.<br>
+      </description><br>
+      <arg name="id" type="new_id" interface="zxdg_tooltip_v6"/><br>
+      <arg name="parent" type="object" interface="zxdg_surface_v6"/><br></blockquote><div> </div><div><div>This seems to combine creation of the surface and assignment of a 
role, at least that is my best guess. No matter what this does this documentation seems misleading.<br><br></div><div>If in fact this is assigning the "tooltip role" to an existing surface, then the "parent" argument name is really misleading. That surface *is* the tooltip.<br><br></div><div>If this is creating a new surface with the "tooltip role" then the text "assign the xdg_tooltip surface role" is misleading. It is also rather mysterious how you do things like set the buffer.</div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
+  <interface name="zxdg_tooltip_v6"><br>
+    <request name="destroy" type="destructor"><br>
+      Unmap the tooltip surface and destroy the object.<br>
+    </request><br></blockquote><div><br></div><div>Why isn't the wl_surface destroy request used? Or if you do not have access to surface methods, how do you do basic things like set the buffer?<br><br></div></div></div></div>