Updated documentation on events.
Merge pull request #217 from hayesr/event_doc

Updated documentation on events.