Fix some dart:io documentation comments.

sdk/lib/io/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.
 
 part of dart.io;
 
 // TODO(ager): The only reason for this class is that we
 // cannot patch a top-level at this point.
 class _ProcessUtils {
   external static _exit(int status);
@@ skipping 61 matching lines @@
    *
    * Returns a [:Future<ProcessResult>:] that completes with the
    * result of running the process, i.e., exit code, standard out and
    * standard in.
    */
   external static Future<ProcessResult> run(String executable,
                                             List<String> arguments,
                                             [ProcessOptions options]);
 
   /**
-   * Returns an input stream of the process stdout.
+   * Returns the standard output stream of the process as a [:Stream:].

[Søren Gjesse, 2013/02/25 09:15:05]

For consistency either remove ::'s here or add them to [IOSink].

[Bill Hesse, 2013/02/25 14:55:25]

But IOSink is a class in this library, and the link works.

    *
    * Throws an [UnsupportedError] if the process is
    * non-interactive.
    */
   Stream<List<int>> get stdout;
 
   /**
-   * Returns an input stream of the process stderr.
+   * Returns the standard error stream of the process as a [:Stream:].
    *
    * Throws an [UnsupportedError] if the process is
    * non-interactive.
    */
   Stream<List<int>> get stderr;
 
   /**
-   * Returns an output stream to the process stdin.
+   * Returns the standard input stream of the process as an [IOSink].
    *
    * Throws an [UnsupportedError] if the process is
    * non-interactive.
    */
   IOSink<Process> get stdin;
 
   /**
-   * Sets an exit handler which gets invoked when the process
-   * terminates.
+   * Returns a [:Future:] which completes with the exit code of the process
+   * when the process completes.
    *
    * Throws an [UnsupportedError] if the process is
    * non-interactive.
    */
   Future<int> exitCode;
 
   /**
    * On Windows, [kill] kills the process, ignoring the [signal]
    * flag. On Posix systems, [kill] sends [signal] to the
    * process. Depending on the signal giving, it'll have different
@@ skipping 141 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;
 }