Update documentation on Process.close to explain issues with closing before reading out all content…

runtime/bin/process.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 /**
  * [Process] is used to start new processes using the static
  * [start] and [run] methods.
  */
 class Process {
   /**
@@ skipping 80 matching lines @@
   abstract void set onError(void callback(e));
 
   /**
    * Kills the process. When the process terminates as a result of
    * calling [kill] [onExit] is called. If the kill operation fails,
    * [onError] is called.
    */
   abstract void kill();
 
   /**
-   * Terminates the streams of a process. [close] most be called on a
-   * process to free the system resources associated with it. Usually,
-   * close should be called in [onExit]. Once a process has been
-   * closed it can no longer be killed and [onExit] is detached so the
-   * application is not notified of process termination.
+   * Terminates the streams of a process. [close] must be called on a
+   * process to free the system resources associated with it if not all
+   * data on the stdout and stderr streams have been read. Usually,
+   * close should be called in [onExit], but care must be taken to actually
+   * wait on the stderr and stdout streams to close if all data is required.
+   * Once a process has been closed it can no longer be killed and [onExit]
+   * is detached so the application is not notified of process termination.
    */
   abstract void close();
 }
 
 
 /**
  * [ProcessResult] represents the result of running a non-interactive
  * process started with [:Process.run:].
  */
 interface ProcessResult {
@@ skipping 68 matching lines @@
   /**
    * Contains the system message for the process exception if any.
    */
   final String message;
 
   /**
    * Contains the OS error code for the process exception if any.
    */
   final int errorCode;
 }