Align event listener specification with real implementations

The specification of event listeners is changed to take a single parameter of type "event". This aligns with the Orca stub and reflector implementations currently available. Small improvements are also made to the layout and content of the JSDoc comments.
Update to reflect current status/positioning
Correction of typos
Merge pull request #12 from sharpie7/master

Alignment updates and JSDoc improvements