Corrected API method name (#1330)

Corrected API method name (issue #1330) and added helpful message on using events.

I was confused for a while regarding how to use the events, so it might help someone else.