added doc blocks to Events class
some changes