doc: update removeListener behaviour

This commit updates events doc to describe removeListener behaviour when it is called within a listener. An example is added to make it more evident.

A test is also incuded to make this behaviour consistent in future releases. ref #4764 fixes #4759 (closed) @cjihrig @jasnell