improved the docs for EventWatcher class

added an example and clarified a bunch

also fixed a typo in the docstring for non_reentrant