doc: note stdout and stderr special behaviors.

Reviewed-By: Trevor Norris <trev.norris@gmail.com>
Reviewed-By: Chris Dickinson <christopher.s.dickinson@gmail.com>

diff --git a/doc/api/process.markdown b/doc/api/process.markdown
index 68bb2a6..614f5cf 100644 (file)
--- a/doc/api/process.markdown
+++ b/doc/api/process.markdown
@@ -181,7 +181,8 @@ Example: the definition of `console.log`
     };
 
 `process.stderr` and `process.stdout` are unlike other streams in Node in
-that writes to them are usually blocking.
+that they cannot be closed (`end()` will throw), they never emit the `finish`
+event and that writes are usually blocking.
 
 - They are blocking in the case that they refer to regular files or TTY file
   descriptors.
@@ -209,7 +210,8 @@ See [the tty docs](tty.html#tty_tty) for more information.
 A writable stream to stderr.
 
 `process.stderr` and `process.stdout` are unlike other streams in Node in
-that writes to them are usually blocking.
+that they cannot be closed (`end()` will throw), they never emit the `finish`
+event and that writes are usually blocking.
 
 - They are blocking in the case that they refer to regular files or TTY file
   descriptors.