Documentation comments in event-machine.h

Comments should be Doxygen friendly, but it wasn't tested yet.