events.markdown document improvements

Improvements to events.markdown documentation per #8853 (same fix as before but rebased on joyent/v0.10
Done. https://github.com/jasnell/node/commit/c91b2fa00865e5f9d1829f3eb354e2f44bbfe841