documenting  that on() handler accepts .trigger() args #472

See #472 for the complete story. Basically;

 1. Added `extraParameter` to the signature, and added further documentation as to how it works.
 2. Added examples of using `on()` and `trigger()`.
 3. Various tidyings

... all separated into separate commits.