debug options & event listeners
finished work on events and documented them.

still some work to document the events for them to turn up nicely in
the doc, but it's a start...
added docs