--- a/docs/events.rst Wed Jan 30 19:44:01 2013 +0100
+++ b/docs/events.rst Wed Jan 30 20:21:08 2013 +0100
@@ -52,3 +52,19 @@
Normal events are propagated in top down order, to all children in each level, in order of child addition.
Some events choose one or more of children for event propagation. In case of mouse events, child is chosen based on mouse cursor position.
+
+Standard events
+---------------
+
+* mousedown
+ - report button press (left, mdiddle, right)
+* mouseup
+ - report button released
+* mousemove
+ - report mouse position change (only when button pressed)
+ - for use in combination with mousedown, mouseup
+* mousehover
+ - report mouse position change (only when all buttons released)
+* mousewheel
+ - report wheel up, down (as buttons)
+