From: Matthias Clasen <mcla...@redhat.com>
Some descriptions were missing here.
---
protocol/wayland.xml | 36 +++++++++++++++++++++++++++---------
1 file changed, 27 insertions(+), 9 deletions(-)
diff --git a/protocol/wayland.xml b/protocol/wayland.xml
index 52bc98f..a53cb71 100644
--- a/protocol/wayland.xml
+++ b/protocol/wayland.xml
@@ -1391,29 +1391,48 @@
</interface>
<interface name="wl_touch" version="1">
- <description summary="touch screen input device">
+ <description summary="touchscreen input device">
+ The wl_touch interface represents a touchscreen
+ associated with a seat.
+
+ Touch interactions can consist of one or more contacts.
+ For each contact, a series of events is generated, starting
+ with a down event, followed by one or more motion events,
+ and ended with an up event. Events relating to the same
+ contact point can be identified by the ID of the sequence.
</description>
<event name="down">
+ <description summary="touch down event">
+ Notifies the client of a new contact point on one
+ of its surfaces.
+ </description>
<arg name="serial" type="uint"/>
<arg name="time" type="uint"/>
<arg name="surface" type="object" interface="wl_surface"/>
- <arg name="id" type="int" />
- <arg name="x" type="fixed" />
- <arg name="y" type="fixed" />
+ <arg name="id" type="int" summary="ID of the touch sequence"/>
+ <arg name="x" type="fixed"/>
+ <arg name="y" type="fixed"/>
</event>
<event name="up">
+ <description summary="touch up event">
+ Notifies the client that a touch has ended.
+ </description>
<arg name="serial" type="uint"/>
<arg name="time" type="uint"/>
- <arg name="id" type="int" />
+ <arg name="id" type="int"/>
</event>
<event name="motion">
+ <description summary="touch motion event">
+ Notifies the client that the position of a contact point
+ has changed.
+ </description>
<arg name="time" type="uint"/>
- <arg name="id" type="int" />
- <arg name="x" type="fixed" />
- <arg name="y" type="fixed" />
+ <arg name="id" type="int" summary="ID of the touch sequence"/>
+ <arg name="x" type="fixed"/>
+ <arg name="y" type="fixed"/>
</event>
<event name="frame">
@@ -1431,7 +1450,6 @@
</event>
</interface>
-
<interface name="wl_output" version="1">
<description summary="compositor output region">
An output describes part of the compositor geometry. The
--
1.8.1.4
_______________________________________________
wayland-devel mailing list
wayland-devel@lists.freedesktop.org
http://lists.freedesktop.org/mailman/listinfo/wayland-devel
