diff --git a/src/declarativeimports/qtextracomponents/mouseeventlistener.h b/src/declarativeimports/qtextracomponents/mouseeventlistener.h
index 794084696..6e3e1a80b 100644
--- a/src/declarativeimports/qtextracomponents/mouseeventlistener.h
+++ b/src/declarativeimports/qtextracomponents/mouseeventlistener.h
@@ -23,6 +23,15 @@
 
 #include <QQuickItem>
 
+/**
+ * This item spies on mouse events from all child objects including child MouseAreas regardless
+ * of whether the child MouseArea propegates events. It does not accept the event.
+ *
+ * In addition unlike MouseArea events include the mouse position in global co-ordinates and provides
+ * the sceen the mouse is in.
+ */
+
+
 class KDeclarativeMouseEvent : public QObject
 {
     Q_OBJECT