use an object for the event, document the event

Signed-off-by: Chris Granger <ibdknox@gmail.com>