Document events and arguments better

[DanielOaks]

We should be dynamically generating the event list and arguments for the docs. We can do this with Sphinx and Py integration, though it may limit our docs to building with Py3-only.