API Documentation bug

[smcmurray]

The documentation is almost completely lacking details about event handlers.
The docs should be explicit about the arguments passed to the handler, and about the context (this) of the handler.