Issue #595 - added docs on the events param, and sample code to indicate how to use it.