added documentation of the general event mechanism