doc: clarification on the 'close' event

jasnell · rvagg · commit 52018e73d9a7 · 2015-08-26T21:18:56.000+10:00
per: nodejs/node-v0.x-archive#8209 originally submitted by @jeromew Reviewed By: Sakthipriyan Vairamani <thechargingvolcano@gmail.com> PR-URL: #2378
diff --git a/doc/api/stream.markdown b/doc/api/stream.markdown
@@ -230,8 +230,11 @@ readable.on('end', function() {
 
 #### Event: 'close'
 
-Emitted when the underlying resource (for example, the backing file
-descriptor) has been closed. Not all streams will emit this.
+Emitted when the stream and any of its underlying resources (a file
+descriptor, for example) have been closed, no more events will be
+emitted, and no further computation will occur.
+
+Not all streams will emit the 'close' event.
 
 #### Event: 'error'
 
