I've pushed a new commit with more precise description of event handling.  Let me know what you think.