Add missing lua event docs

[Doralitze]

The lua event API needs complete documentation of all methods and an example would be nice. Moving the documentation from the filter into a separate part of the complete documentation would be helpful as well.

This could be complemented with a set of tutorials.