Add some docs about the break-on-DOM-events stuff.

This can probably be better reviewed in bug 832982.