docs: add cautionary note to emitter.removeAllListeners

Signed-off-by: Fedor Indutny <fedor@indutny.com>
heapwolf · Apr 29, 2014 · 793c76e · 793c76e
1 parent 3f3a71e
commit 793c76e
Showing 1 changed file with 3 additions and 1 deletion.
diff --git 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.