docs: add cautionary note to emitter.removeAllListeners

Signed-off-by: Fedor Indutny <fedor@indutny.com>
11 years ago · 793c76e5c6
1 changed files with 3 additions and 1 deletions
--- a/doc/api/events.markdown
+++ b/doc/api/events.markdown
@ -69,7 +69,9 @@ Returns emitter, so calls can be chained.

 ### emitter.removeAllListeners([event])

-Removes all listeners, or those of the specified event.
+Removes all listeners, or those of the specified event. It's not a good idea to
+remove listeners that were added elsewhere in the code, especially when it's on
+an emitter that you didn't create (e.g. sockets or file streams).

 Returns emitter, so calls can be chained.