He's right, i've been re-thinking about this API.
Seems to me some points are missing, and better details are needed.
Example : Listeners, events associated, and event objects methods.
I'm not willing to correct today (i take my exam at 2:00 pm) but i'll have a look later.
Any comments are welcome, thanks for pointing the weak points of my docs.