Reformat the explanation of events.

This is a document format experiment to see if it improves understanding of emitted events and their handlers.
Merge pull request #11 from smcmurray/patch-1

Reformat the explanation of events.